> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Beneficiary

> Replace all profile fields on an existing beneficiary

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}
```

<Note>
  Requires an `Idempotency-Key` header.
</Note>

## Path parameters

<ParamField path="id" type="string" required>
  The ID of the beneficiary to update.
</ParamField>

## Request body

<ParamField body="recipient_type" type="string" required>
  Beneficiary type: `"individual"` or `"business"`.
</ParamField>

<ParamField body="customer_name" type="string" required>
  Full name of the beneficiary (individual) or legal business name.
</ParamField>

<ParamField body="customer_email" type="string" required>
  Beneficiary's email address.
</ParamField>

<ParamField body="customer_address" type="string" required>
  Beneficiary's physical address.
</ParamField>

<ParamField body="country" type="string" required>
  Beneficiary's country code (e.g. `CHL`, `MEX`, `BRA`).
</ParamField>

<ParamField body="customer_nickname" type="string">
  A short label for this beneficiary. Defaults to `customer_name` if omitted.
</ParamField>

<Warning>
  This endpoint performs a **full replacement**. You must send all required fields on every call, not just the fields you want to change.
</Warning>

<RequestExample>
  ```bash cURL theme={null}
  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"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "message": "Beneficiary updated successfully"
  }
  ```
</ResponseExample>