---
title: "Create Bank Account Beneficiary"
method: POST
path: "/v1/accounts/{account_id}/beneficiaries"
---

# Create Bank Account Beneficiary

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

Use this API to add a bank account beneficiary to an account.

## Path parameters

- `account_id` string, required

## Request body

- object
  - `type` string, required — Type of account details linked to the beneficiary.<br><br>Possible value:<ul><li>`account_number`</li></ul>
  - `name_of_account_holder` string, required — Beneficiary's name.<br><br>Supported 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 — Beneficiary's email address.<br><br>Example: `anil.reddy@example.com`
  - `phone` string — Beneficiary's phone number.<br><br>Example: `9876543210`
  - `bank_account_number` string, required — Beneficiary's bank account number.<br><br>Example: `98765432101234`
  - `bank_ifsc_code` string, required — Beneficiary's bank IFSC.<br><br>Example: `HDFC0000123`
  - `bank_name` string — Beneficiary bank name
  - `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` string
  - `metadata` object
    - `key_1` string
    - `key_2` 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)