curl -X PUT 'https://api.yativo.com/api/v1/beneficiaries/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
Update Beneficiary
Replace all profile fields on an existing beneficiary
PUT
/
beneficiaries
/
{id}
curl -X PUT 'https://api.yativo.com/api/v1/beneficiaries/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
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.Request body
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 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Path Parameters
The ID of the beneficiary to update.
Body
application/json
Beneficiary type: "individual" or "business".
Available options:
individual, business Full name of the beneficiary (individual) or legal business name.
Beneficiary's email address.
Beneficiary's physical address.
Beneficiary's country code (e.g. CHL, MEX, BRA).
A short label for this beneficiary. Defaults to customer_name if omitted.
Response
200 - application/json
Beneficiary updated