> ## 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 Payment Destination

> Update a payment destination's default flag

Updates a payment destination. Only the `is_default` flag is client-editable — all financial fields (account numbers, IBAN, SWIFT, etc.) are immutable after creation. To change account details, create a new destination and disable the old one.

<Warning>
  Fields other than `is_default` are ignored or rejected. Financial details cannot be edited in place.
</Warning>

## Path Parameters

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

<ParamField path="beneficiary_id" type="string" required>
  Id of the parent beneficiary (e.g. `bene_...`).
</ParamField>

<ParamField path="id" type="string" required>
  Destination id (e.g. `dest_…`).
</ParamField>

## Request Body

<ParamField body="is_default" type="boolean | null">
  Set to `true` to make this the beneficiary's default destination.
</ParamField>

## Response

Returns the updated `payment_destination` object.

<RequestExample>
  ```json Request theme={null}
  {
    "is_default": true
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "object": "payment_destination",
    "id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
    "beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
    "country": "GB",
    "type": "bank_account",
    "currency": "GBP",
    "status": "active",
    "account_number_last4": "****6819",
    "iban_masked": "GB29****6819",
    "is_default": true,
    "created": "2026-05-01T10:05:00Z",
    "updated": "2026-05-10T14:30:00Z",
    "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
    "updated_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4"
  }
  ```
</ResponseExample>