Skip to main content
POST
Create Payout Destination

Path Parameters

string
required
The account’s external ID (starts with acct_)
string
required
The beneficiary’s external ID (starts with bene_)

Request Body

string
required
Payout country code (ISO 3166-1 alpha-2)
string
required
Destination type: bank_account, wallet, or card
string
required
Currency for payouts (ISO 4217 code)
string
Custom label for this destination
string
Blockchain network (required for crypto destinations, e.g., ethereum, bitcoin)

Bank Account Fields

string
Bank account number
string
Bank account name
string
Bank routing number
string
Account type: checking or savings
string
IBAN (max 34 characters)
string
SWIFT/BIC code (max 11 characters)

Crypto Wallet Fields

string
Blockchain wallet address
boolean
default:"false"
Set as default destination for this beneficiary

Response

string
Payout destination identifier (starts with dest_)
string
Always returns "payout_destination"
string
Parent beneficiary external ID
string
Payout country
string
Payout method (e.g., ach, wire, spei)
string
Destination type
string
Destination label
string
Currency
string
Blockchain network (for crypto only)
string
Destination status: active, disabled, or inactive
string
Last 4 digits of account number (masked for security)
string
Bank routing number
string
Account type
string
Last 4 digits of CLABE (Mexico SPEI)
string
Masked IBAN
string
SWIFT/BIC code
string
Masked wallet address
boolean
Whether this is the default destination
string
ISO 8601 timestamp when created
string
ISO 8601 timestamp when last updated

Response Example