Skip to main content
Fully replace a beneficiary’s profile information. This is a full replacement — all required fields must be included in every request. Omitting a required field will overwrite it with an empty or default value.
Requires an Idempotency-Key header.

Path parameters

string
required
The ID of the beneficiary to update.

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.
This endpoint performs a full replacement. You must send all required fields on every call, not just the fields you want to change.