---
title: "Update Beneficiary"
method: POST
path: "/v1/accounts/beneficiaries/{beneficiary_id}"
---

# Update Beneficiary

`POST /v1/accounts/beneficiaries/{beneficiary_id}`

Use this API to update the details of a beneficiary.

## Path parameters

- `beneficiary_id` string, required

## Request body

- object
  - `name_of_account_holder` string — Account holder's name.<br><br>Allowed characters: <ul><li>`a-z`</li><li>`A-Z`</li><li>`0-9`</li><li>`space`</li><li>`’`</li><li>`-`</li><li>`_`</li><li>`/`</li><li>`(`</li><li>`)`</li><li>`.`</li><li>`&`</li><li>`#`</li><li>`$`</li><li>`@`</ul></li>Example: `Anil Reddy`
  - `email` string — Account holder's email address.<br><br>Example: `anil.reddy@example.com`
  - `phone` string — Account holder's phone number.<br><br>Example: `9876543210`
  - `metadata` object — Key-value pair that can be used to store additional information about the entity.<ul><li>Each pair cannot exceed 256 characters.</li><li>Maximum 5 key-value pairs.</li></ul>Example: `"key_1": "DD”`
    - `key_1` string
    - `key_2` string

## Response `200`

200

- object
  - `id` string
  - `object` string
  - `type` string
  - `name_of_account_holder` string
  - `email` string
  - `phone` string
  - `bank_account_number` string
  - `bank_ifsc_code` string
  - `bank_name` unknown
  - `metadata` object
    - `key_1` string
    - `key_2` string
    - `key_3` string
  - `created_at` integer
  - `status` string
  - `is_sandbox` boolean
  - `account_id` string

## Other responses

- `401` — 401
- `422` — 422

---

[API](https://skmtc.net/zwitch/apis/2.md) · [All operations](https://skmtc.net/zwitch/apis/2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zwitch/2/revisions/4586157daf87/schema)