Skip to main content
POST
/
api
/
recipients
Create Recipient
curl --request POST \
  --url https://api.example.com/api/recipients \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessName": "<string>",
  "country": "<string>",
  "currency": "<string>",
  "transferType": "<string>",
  "bankName": "<string>",
  "bankAccount": "<string>",
  "walletAddresses": {}
}
'
{
  "id": "rec_abc123",
  "businessName": "Acme Malaysia",
  "status": "provisioning"
}
​
Authorization
string
required
Bearer token from Auth0
​
businessName
string
required
Recipient business name
​
country
string
required
Country code (ISO 3166-1 alpha-2)
​
currency
string
Currency code for fiat recipients
​
transferType
string
required
fiat_to_fiat, fiat_to_stablecoin, or stablecoin_to_stablecoin
​
bankName
string
Bank name (for fiat recipients)
​
bankAccount
string
Bank account number (for fiat recipients)
​
walletAddresses
object
Wallet addresses by chain ID (for stablecoin recipients). Example: {"42161": "0x..."}
{
  "id": "rec_abc123",
  "businessName": "Acme Malaysia",
  "status": "provisioning"
}