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

# Update Beneficiary

> Update the mutable fields of a beneficiary

Updates the mutable fields of a beneficiary. All request fields are optional; only the fields provided are changed.

<Warning>
  `beneficiary_type`, `first_name` / `middle_name` / `last_name`, `company_name`, `status`, and `verified` are not client-editable. To change identity details, create a new beneficiary; to change status, use the disable action.
</Warning>

## Path Parameters

<ParamField path="account_id" type="string" required>
  Id of the parent account (e.g. `acct_...`).
</ParamField>

<ParamField path="id" type="string" required>
  Beneficiary id (e.g. `bene_...`).
</ParamField>

## Request Body

<ParamField body="display_name" type="string | null">
  Max 255 characters.
</ParamField>

<ParamField body="email" type="string | null">
  Max 255 characters.
</ParamField>

<ParamField body="phone" type="string | null">
  Max 50 characters.
</ParamField>

<ParamField body="address" type="Address | null">
  Replacement address object. If provided, all Address sub-fields are required and `country` must be ISO 3166-1 alpha-2.

  <Expandable title="child attributes">
    <ParamField body="address_line" type="string" required>
      Street address.
    </ParamField>

    <ParamField body="city" type="string" required>
      Max 100 characters.
    </ParamField>

    <ParamField body="region" type="string" required>
      State, province, or region. Max 100 characters.
    </ParamField>

    <ParamField body="postal_code" type="string" required>
      Max 20 characters.
    </ParamField>

    <ParamField body="country" type="string" required>
      Country code string. Send an ISO 3166-1 alpha-2 value.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="country_code" type="PaymentCountry | null">
  ISO 3166-1 alpha-2 country code on the payment-country allowlist.
</ParamField>

## Response

Returns 200 with the updated beneficiary object.

<RequestExample>
  ```json Request theme={null}
  {
    "display_name": "Globex UK",
    "email": "payments@globex.example",
    "phone": "+44 20 7946 0000"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "object": "beneficiary",
    "id": "bene_9f2c1d7e8a4bx0y1z2a3b4c5",
    "account_id": "acct_4d8e2a1b9c3fx0y1z2a3b4c5",
    "beneficiary_type": "business",
    "display_name": "Globex UK",
    "company_name": "Globex Limited",
    "email": "payments@globex.example",
    "phone": "+44 20 7946 0000",
    "country_code": "GB",
    "status": "active",
    "verified": true,
    "payment_destinations": [],
    "created": "2026-06-10T09:15:00Z",
    "updated": "2026-06-11T08:30:00Z",
    "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
    "updated_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4"
  }
  ```
</ResponseExample>