Create a magic link

Create a magic link

curl --request POST \
  --url https://raas-widgets-backend-sandbox.up.railway.app/partner/links \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "referenceId": "user-12345",
  "flow": "m2m",
  "externalId": "ORD-2026-001",
  "expiresInMinutes": 120,
  "metadata": {
    "orderId": "ORD-2026-001",
    "campaign": "february-promo"
  },
  "theme": {
    "name": "lola-default-dark",
    "tokens": {
      "color-accent": "#1dafa1"
    }
  },
  "language": "es",
  "callbackUrl": "https://api.example.com/callbacks/m2m",
  "headerName": "Lola Send",
  "cipTemplateId": "raas-v1",
  "presentation": {
    "showSplash": true,
    "showAgreement": false
  },
  "config": {
    "flavor": "C",
    "themeMode": "dark",
    "sourceCountry": "US",
    "destinationCountry": "MX",
    "sourceCurrency": "USD",
    "destinationCurrency": "MXN"
  }
}
'

import requests

url = "https://raas-widgets-backend-sandbox.up.railway.app/partner/links"

payload = {
    "referenceId": "user-12345",
    "flow": "m2m",
    "externalId": "ORD-2026-001",
    "expiresInMinutes": 120,
    "metadata": {
        "orderId": "ORD-2026-001",
        "campaign": "february-promo"
    },
    "theme": {
        "name": "lola-default-dark",
        "tokens": { "color-accent": "#1dafa1" }
    },
    "language": "es",
    "callbackUrl": "https://api.example.com/callbacks/m2m",
    "headerName": "Lola Send",
    "cipTemplateId": "raas-v1",
    "presentation": {
        "showSplash": True,
        "showAgreement": False
    },
    "config": {
        "flavor": "C",
        "themeMode": "dark",
        "sourceCountry": "US",
        "destinationCountry": "MX",
        "sourceCurrency": "USD",
        "destinationCurrency": "MXN"
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    referenceId: 'user-12345',
    flow: 'm2m',
    externalId: 'ORD-2026-001',
    expiresInMinutes: 120,
    metadata: {orderId: 'ORD-2026-001', campaign: 'february-promo'},
    theme: {name: 'lola-default-dark', tokens: {'color-accent': '#1dafa1'}},
    language: 'es',
    callbackUrl: 'https://api.example.com/callbacks/m2m',
    headerName: 'Lola Send',
    cipTemplateId: 'raas-v1',
    presentation: {showSplash: true, showAgreement: false},
    config: {
      flavor: 'C',
      themeMode: 'dark',
      sourceCountry: 'US',
      destinationCountry: 'MX',
      sourceCurrency: 'USD',
      destinationCurrency: 'MXN'
    }
  })
};

fetch('https://raas-widgets-backend-sandbox.up.railway.app/partner/links', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://raas-widgets-backend-sandbox.up.railway.app/partner/links",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'referenceId' => 'user-12345',
    'flow' => 'm2m',
    'externalId' => 'ORD-2026-001',
    'expiresInMinutes' => 120,
    'metadata' => [
        'orderId' => 'ORD-2026-001',
        'campaign' => 'february-promo'
    ],
    'theme' => [
        'name' => 'lola-default-dark',
        'tokens' => [
                'color-accent' => '#1dafa1'
        ]
    ],
    'language' => 'es',
    'callbackUrl' => 'https://api.example.com/callbacks/m2m',
    'headerName' => 'Lola Send',
    'cipTemplateId' => 'raas-v1',
    'presentation' => [
        'showSplash' => true,
        'showAgreement' => false
    ],
    'config' => [
        'flavor' => 'C',
        'themeMode' => 'dark',
        'sourceCountry' => 'US',
        'destinationCountry' => 'MX',
        'sourceCurrency' => 'USD',
        'destinationCurrency' => 'MXN'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://raas-widgets-backend-sandbox.up.railway.app/partner/links"

	payload := strings.NewReader("{\n  \"referenceId\": \"user-12345\",\n  \"flow\": \"m2m\",\n  \"externalId\": \"ORD-2026-001\",\n  \"expiresInMinutes\": 120,\n  \"metadata\": {\n    \"orderId\": \"ORD-2026-001\",\n    \"campaign\": \"february-promo\"\n  },\n  \"theme\": {\n    \"name\": \"lola-default-dark\",\n    \"tokens\": {\n      \"color-accent\": \"#1dafa1\"\n    }\n  },\n  \"language\": \"es\",\n  \"callbackUrl\": \"https://api.example.com/callbacks/m2m\",\n  \"headerName\": \"Lola Send\",\n  \"cipTemplateId\": \"raas-v1\",\n  \"presentation\": {\n    \"showSplash\": true,\n    \"showAgreement\": false\n  },\n  \"config\": {\n    \"flavor\": \"C\",\n    \"themeMode\": \"dark\",\n    \"sourceCountry\": \"US\",\n    \"destinationCountry\": \"MX\",\n    \"sourceCurrency\": \"USD\",\n    \"destinationCurrency\": \"MXN\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://raas-widgets-backend-sandbox.up.railway.app/partner/links")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"referenceId\": \"user-12345\",\n  \"flow\": \"m2m\",\n  \"externalId\": \"ORD-2026-001\",\n  \"expiresInMinutes\": 120,\n  \"metadata\": {\n    \"orderId\": \"ORD-2026-001\",\n    \"campaign\": \"february-promo\"\n  },\n  \"theme\": {\n    \"name\": \"lola-default-dark\",\n    \"tokens\": {\n      \"color-accent\": \"#1dafa1\"\n    }\n  },\n  \"language\": \"es\",\n  \"callbackUrl\": \"https://api.example.com/callbacks/m2m\",\n  \"headerName\": \"Lola Send\",\n  \"cipTemplateId\": \"raas-v1\",\n  \"presentation\": {\n    \"showSplash\": true,\n    \"showAgreement\": false\n  },\n  \"config\": {\n    \"flavor\": \"C\",\n    \"themeMode\": \"dark\",\n    \"sourceCountry\": \"US\",\n    \"destinationCountry\": \"MX\",\n    \"sourceCurrency\": \"USD\",\n    \"destinationCurrency\": \"MXN\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://raas-widgets-backend-sandbox.up.railway.app/partner/links")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"referenceId\": \"user-12345\",\n  \"flow\": \"m2m\",\n  \"externalId\": \"ORD-2026-001\",\n  \"expiresInMinutes\": 120,\n  \"metadata\": {\n    \"orderId\": \"ORD-2026-001\",\n    \"campaign\": \"february-promo\"\n  },\n  \"theme\": {\n    \"name\": \"lola-default-dark\",\n    \"tokens\": {\n      \"color-accent\": \"#1dafa1\"\n    }\n  },\n  \"language\": \"es\",\n  \"callbackUrl\": \"https://api.example.com/callbacks/m2m\",\n  \"headerName\": \"Lola Send\",\n  \"cipTemplateId\": \"raas-v1\",\n  \"presentation\": {\n    \"showSplash\": true,\n    \"showAgreement\": false\n  },\n  \"config\": {\n    \"flavor\": \"C\",\n    \"themeMode\": \"dark\",\n    \"sourceCountry\": \"US\",\n    \"destinationCountry\": \"MX\",\n    \"sourceCurrency\": \"USD\",\n    \"destinationCurrency\": \"MXN\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "linkId": "link_acme_m2m_a1b2c3d4e5f6",
    "referenceId": "user-12345",
    "status": "created",
    "url": "https://flows.sandbox.raas-widgets.leapfinancial.com/link_acme_m2m_a1b2c3d4e5f6",
    "token": "550e8400-e29b-41d4-a716-446655440000",
    "expiresAt": "2026-02-11T12:00:00.000Z",
    "createdAt": "2026-02-10T12:00:00.000Z",
    "externalId": "ORD-2026-001"
  }
}

POST

partner

links

Create a magic link

curl --request POST \
  --url https://raas-widgets-backend-sandbox.up.railway.app/partner/links \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "referenceId": "user-12345",
  "flow": "m2m",
  "externalId": "ORD-2026-001",
  "expiresInMinutes": 120,
  "metadata": {
    "orderId": "ORD-2026-001",
    "campaign": "february-promo"
  },
  "theme": {
    "name": "lola-default-dark",
    "tokens": {
      "color-accent": "#1dafa1"
    }
  },
  "language": "es",
  "callbackUrl": "https://api.example.com/callbacks/m2m",
  "headerName": "Lola Send",
  "cipTemplateId": "raas-v1",
  "presentation": {
    "showSplash": true,
    "showAgreement": false
  },
  "config": {
    "flavor": "C",
    "themeMode": "dark",
    "sourceCountry": "US",
    "destinationCountry": "MX",
    "sourceCurrency": "USD",
    "destinationCurrency": "MXN"
  }
}
'

import requests

url = "https://raas-widgets-backend-sandbox.up.railway.app/partner/links"

payload = {
    "referenceId": "user-12345",
    "flow": "m2m",
    "externalId": "ORD-2026-001",
    "expiresInMinutes": 120,
    "metadata": {
        "orderId": "ORD-2026-001",
        "campaign": "february-promo"
    },
    "theme": {
        "name": "lola-default-dark",
        "tokens": { "color-accent": "#1dafa1" }
    },
    "language": "es",
    "callbackUrl": "https://api.example.com/callbacks/m2m",
    "headerName": "Lola Send",
    "cipTemplateId": "raas-v1",
    "presentation": {
        "showSplash": True,
        "showAgreement": False
    },
    "config": {
        "flavor": "C",
        "themeMode": "dark",
        "sourceCountry": "US",
        "destinationCountry": "MX",
        "sourceCurrency": "USD",
        "destinationCurrency": "MXN"
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    referenceId: 'user-12345',
    flow: 'm2m',
    externalId: 'ORD-2026-001',
    expiresInMinutes: 120,
    metadata: {orderId: 'ORD-2026-001', campaign: 'february-promo'},
    theme: {name: 'lola-default-dark', tokens: {'color-accent': '#1dafa1'}},
    language: 'es',
    callbackUrl: 'https://api.example.com/callbacks/m2m',
    headerName: 'Lola Send',
    cipTemplateId: 'raas-v1',
    presentation: {showSplash: true, showAgreement: false},
    config: {
      flavor: 'C',
      themeMode: 'dark',
      sourceCountry: 'US',
      destinationCountry: 'MX',
      sourceCurrency: 'USD',
      destinationCurrency: 'MXN'
    }
  })
};

fetch('https://raas-widgets-backend-sandbox.up.railway.app/partner/links', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://raas-widgets-backend-sandbox.up.railway.app/partner/links",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'referenceId' => 'user-12345',
    'flow' => 'm2m',
    'externalId' => 'ORD-2026-001',
    'expiresInMinutes' => 120,
    'metadata' => [
        'orderId' => 'ORD-2026-001',
        'campaign' => 'february-promo'
    ],
    'theme' => [
        'name' => 'lola-default-dark',
        'tokens' => [
                'color-accent' => '#1dafa1'
        ]
    ],
    'language' => 'es',
    'callbackUrl' => 'https://api.example.com/callbacks/m2m',
    'headerName' => 'Lola Send',
    'cipTemplateId' => 'raas-v1',
    'presentation' => [
        'showSplash' => true,
        'showAgreement' => false
    ],
    'config' => [
        'flavor' => 'C',
        'themeMode' => 'dark',
        'sourceCountry' => 'US',
        'destinationCountry' => 'MX',
        'sourceCurrency' => 'USD',
        'destinationCurrency' => 'MXN'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://raas-widgets-backend-sandbox.up.railway.app/partner/links"

	payload := strings.NewReader("{\n  \"referenceId\": \"user-12345\",\n  \"flow\": \"m2m\",\n  \"externalId\": \"ORD-2026-001\",\n  \"expiresInMinutes\": 120,\n  \"metadata\": {\n    \"orderId\": \"ORD-2026-001\",\n    \"campaign\": \"february-promo\"\n  },\n  \"theme\": {\n    \"name\": \"lola-default-dark\",\n    \"tokens\": {\n      \"color-accent\": \"#1dafa1\"\n    }\n  },\n  \"language\": \"es\",\n  \"callbackUrl\": \"https://api.example.com/callbacks/m2m\",\n  \"headerName\": \"Lola Send\",\n  \"cipTemplateId\": \"raas-v1\",\n  \"presentation\": {\n    \"showSplash\": true,\n    \"showAgreement\": false\n  },\n  \"config\": {\n    \"flavor\": \"C\",\n    \"themeMode\": \"dark\",\n    \"sourceCountry\": \"US\",\n    \"destinationCountry\": \"MX\",\n    \"sourceCurrency\": \"USD\",\n    \"destinationCurrency\": \"MXN\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://raas-widgets-backend-sandbox.up.railway.app/partner/links")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"referenceId\": \"user-12345\",\n  \"flow\": \"m2m\",\n  \"externalId\": \"ORD-2026-001\",\n  \"expiresInMinutes\": 120,\n  \"metadata\": {\n    \"orderId\": \"ORD-2026-001\",\n    \"campaign\": \"february-promo\"\n  },\n  \"theme\": {\n    \"name\": \"lola-default-dark\",\n    \"tokens\": {\n      \"color-accent\": \"#1dafa1\"\n    }\n  },\n  \"language\": \"es\",\n  \"callbackUrl\": \"https://api.example.com/callbacks/m2m\",\n  \"headerName\": \"Lola Send\",\n  \"cipTemplateId\": \"raas-v1\",\n  \"presentation\": {\n    \"showSplash\": true,\n    \"showAgreement\": false\n  },\n  \"config\": {\n    \"flavor\": \"C\",\n    \"themeMode\": \"dark\",\n    \"sourceCountry\": \"US\",\n    \"destinationCountry\": \"MX\",\n    \"sourceCurrency\": \"USD\",\n    \"destinationCurrency\": \"MXN\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://raas-widgets-backend-sandbox.up.railway.app/partner/links")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"referenceId\": \"user-12345\",\n  \"flow\": \"m2m\",\n  \"externalId\": \"ORD-2026-001\",\n  \"expiresInMinutes\": 120,\n  \"metadata\": {\n    \"orderId\": \"ORD-2026-001\",\n    \"campaign\": \"february-promo\"\n  },\n  \"theme\": {\n    \"name\": \"lola-default-dark\",\n    \"tokens\": {\n      \"color-accent\": \"#1dafa1\"\n    }\n  },\n  \"language\": \"es\",\n  \"callbackUrl\": \"https://api.example.com/callbacks/m2m\",\n  \"headerName\": \"Lola Send\",\n  \"cipTemplateId\": \"raas-v1\",\n  \"presentation\": {\n    \"showSplash\": true,\n    \"showAgreement\": false\n  },\n  \"config\": {\n    \"flavor\": \"C\",\n    \"themeMode\": \"dark\",\n    \"sourceCountry\": \"US\",\n    \"destinationCountry\": \"MX\",\n    \"sourceCurrency\": \"USD\",\n    \"destinationCurrency\": \"MXN\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "linkId": "link_acme_m2m_a1b2c3d4e5f6",
    "referenceId": "user-12345",
    "status": "created",
    "url": "https://flows.sandbox.raas-widgets.leapfinancial.com/link_acme_m2m_a1b2c3d4e5f6",
    "token": "550e8400-e29b-41d4-a716-446655440000",
    "expiresAt": "2026-02-11T12:00:00.000Z",
    "createdAt": "2026-02-10T12:00:00.000Z",
    "externalId": "ORD-2026-001"
  }
}

Authorizations

X-API-Key

string

header

required

Your partner API key. Use raas_sandbox_* keys for the sandbox environment and raas_live_* keys for production.

Body

application/json

referenceId

string

required

Your unique identifier for the end user in your system. Used to correlate users with your records and to detect returning users.

Example:

"user-12345"

flow

enum<string>

required

Flow discriminator. Must be "m2m" for this variant.

Available options:

m2m

Example:

"m2m"

externalId

string

Your tracing ID for this link/intent (order id, ticket, invoice, etc.). Copied onto the operation when the transfer is created so you can search operations by this value. Distinct from referenceId (which identifies the user).

Maximum string length: 128

Example:

"ORD-2026-001"

expiresInMinutes

number

default:60

Link time-to-live in minutes. The link becomes inaccessible after expiration. Minimum: 5 minutes. Maximum: 10,080 minutes (7 days). Defaults to the partner-level configuration (usually 60 minutes).

Required range: 5 <= x <= 10080

Example:

120

metadata

object

Arbitrary key-value metadata to attach to the link. Useful for storing internal references, campaign IDs, etc. Returned in link detail and webhook payloads.

Example:

{
  "orderId": "ORD-2026-001",
  "campaign": "february-promo"
}

theme

object

Theme configuration object for the widget. The schema is owned by the flow frontend and is stored as-is. Overrides the partner-level theme.

Example:

{
  "name": "lola-default-dark",
  "tokens": { "color-accent": "#1dafa1" }
}

language

enum<string>

Language code for the widget UI (ISO 639-1). Overrides browser detection.

Available options:

en,

es

Example:

"es"

callbackUrl

string

URL to receive callback notifications for this specific link. Overrides the partner-level webhook URL for link-specific events.

Example:

"https://api.example.com/callbacks/m2m"

headerName

string

Brand name shown in the widget header for this link. When omitted, the widget falls back to the partner display name.

Maximum string length: 80

Example:

"Lola Send"

cipTemplateId

string

Kentucky CIP template ID to use when provisioning the CIP ticket for this link. Overrides the partner-level setting and the global default.

Maximum string length: 120

Example:

"raas-v1"

presentation

object

Link-scoped presentation flags (splash / agreement) common to every flow. Returned to the widget inside the claim config block.

Show child attributes

config

object

M2M-specific configuration: pre-filled user data, transfer flavor, theme mode.

Show child attributes

Response

Magic link created successfully

success

boolean

required

Example:

true

data

object

required

Show child attributes

List magic links Get magic link details

Overview

Endpoints

Partner - Magic Links

Partner - Users

Partner - Data Requests

Partner - Webhooks

Partner - Settings

Partner - Operations

Partner - Requests

Partner - Deferred Payouts

Partner - CIP

Partner - Flows

Partner - Pricing

Authorizations

Body

Response