Skip to main content
Create a beneficiary record to store recipient information for future payouts. After creating a beneficiary, add their payment method details using the payment methods endpoint.
Requires an Idempotency-Key header.

Request body

string
required
Beneficiary type: "individual" or "business".
string
required
Full name of the beneficiary (individual) or legal business name.
string
required
Beneficiary’s email address.
string
required
Beneficiary’s physical address.
string
required
Beneficiary’s country code (e.g. CHL, MEX, BRA).
string
A short label for this beneficiary. Defaults to customer_name if omitted.