Skip to main content
POST
/
partner
/
wallets
/
recipients
Create saved recipient
curl --request POST \
  --url https://api.stabyl.com/v1/partner/wallets/recipients \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "label": "Main USDT recipient",
  "account_name": "Jane Doe",
  "account_number": "0123456789",
  "bank_code": "058",
  "bank_name": "GTBank",
  "chain": "evm",
  "crypto_address": "0x1234...abcd",
  "currency": "USDT"
}
'
{
  "data": {
    "account_name": "Example Recipient",
    "account_number": "0123456789",
    "bank_code": "044",
    "bank_name": "Access Bank",
    "chain": null,
    "created_at": "2026-05-24T12:00:00Z",
    "crypto_address": null,
    "currency": "NGN",
    "id": "0197f1f0-0000-7000-8000-000000000002",
    "label": "Operations account",
    "recipient_type": "fiat",
    "updated_at": "2026-05-24T12:00:00Z"
  },
  "status": "success"
}

Documentation Index

Fetch the complete documentation index at: https://stabyl.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Saved recipients are address book records. Creating, updating, or deleting a recipient does not submit a withdrawal or move funds.

Authorizations

​
X-Api-Key
string
header
default:sb_test_your_key
required

API key. Send it in the X-Api-Key header.

Body

application/json

Recipient details to save in the account address book. This request does not submit a withdrawal.

Recipient details to save in the account address book.

​
label
string
required
Example:

"Main USDT recipient"

​
recipient_type
enum<string>
required

Saved recipient type. Fiat recipients use bank details; crypto recipients use chain and address details.

Available options:
fiat,
crypto
​
account_name
string | null
Example:

"Jane Doe"

​
account_number
string | null
Example:

"0123456789"

​
bank_code
string | null
Example:

"058"

​
bank_name
string | null
Example:

"GTBank"

​
chain
string | null
Example:

"evm"

​
crypto_address
string | null
Example:

"0x1234...abcd"

​
currency
string | null
Example:

"USDT"

Response

Recipient created

​
data
object
required

Saved fiat or crypto recipient record.

​
status
enum<string>
required
Available options:
success