Skip to main content
Update mutable fields on a beneficiary record. Only include the fields you want to change. 
PUT /beneficiaries/{beneficiary_id}
Requires Idempotency-Key header.

​
Path parameters

​
beneficiary_id
string
required
The UUID of the beneficiary to update.

​
Request body

​
name
string
Updated beneficiary name.
​
email
string
Updated email address.
​
country
string
Updated country in ISO 3166-1 alpha-3 format.
curl -X PUT 'https://api.yativo.com/api/v1/beneficiaries/ben-7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: update-beneficiary-maria-001' \
  -d '{
    "email": "maria.g@newemail.com"
  }'

{
  "status": "success",
  "status_code": 200,
  "message": "Beneficiary updated successfully",
  "data": {
    "beneficiary_id": "ben-7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
    "name": "Maria Gonzalez",
    "email": "maria.g@newemail.com",
    "type": "individual",
    "country": "CHL",
    "updated_at": "2026-04-02T14:00:00.000000Z"
  }
}