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. 
PUT /v1/beneficiaries/{id}
Requires an Idempotency-Key header.

​
Path parameters

​
id
string
required
The ID of the beneficiary to update.

​
Request body

​
recipient_type
string
required
Beneficiary type: "individual" or "business".
​
customer_name
string
required
Full name of the beneficiary (individual) or legal business name.
​
customer_email
string
required
Beneficiary’s email address.
​
customer_address
string
required
Beneficiary’s physical address.
​
country
string
required
Beneficiary’s country code (e.g. CHL, MEX, BRA).
​
customer_nickname
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.
curl -X PUT 'https://api.yativo.com/api/v1/beneficiaries/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "recipient_type": "individual",
    "customer_name": "Maria Gonzalez",
    "customer_email": "maria.g@newemail.com",
    "customer_address": "456 New Street, Santiago",
    "country": "CHL",
    "customer_nickname": "Maria G"
  }'

{
  "message": "Beneficiary updated successfully"
}