---
title: "Create a new bank beneficiary"
method: POST
path: "/v0.2.4/beneficiary/bank"
tags: ["Beneficiary"]
---

# Create a new bank beneficiary

`POST /v0.2.4/beneficiary/bank`

## Request

- Base URL: `https://api.chimoney.io`
- URL: `https://api.chimoney.io/v0.2.4/beneficiary/bank`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/chimoney/apis/chimoney-api-docs/docs/v0.2.4/beneficiary/bank/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `beneficiaryData` object, required
    - `accountHolderName` string, required: Name of the account holder (3-100 characters)
    - `accountHolderAddress1` string, required: Primary address of the account holder
    - `accountHolderAddress2` string: Address line 2 of the account holder (optional)
    - `accountHolderCity` string, required: City of the account holder
    - `accountHolderRegion` string: Region/State of the account holder (optional)
    - `accountHolderPostal` string: Postal code of the account holder (optional)
    - `bankName` string, required: Name of the bank
    - `bankCity` string, required: City where the bank is located
    - `bankAddressLine1` string, required: Primary address of the bank
    - `bankRegion` string: Region/State where the bank is located (optional)
    - `bankPostal` string: Postal code of the bank (optional)
    - `accountNumber` string, required: 8-digit account number
    - `routingCode` string, required: 6-digit routing code
    - `classification` 'Individual' | 'Business': Type of beneficiary (optional)
    - `preferredMethod` 'W' | 'E': Preferred payment method Wire or iACH (optional)
    - `currency` string, required: Currency code (e.g., USD)
    - `country` string, required: Country code (e.g., US)

## Response `200`

Success

- object
  - `status` string
  - `message` string
  - `data` object
    - `id` string
    - `beneID` string
    - `templateId` string

## Other responses

- `400`: Validation error in the request.
- `401`: Access to this resource is not available for unauthenticated users.
- `500`: Indicates an internal server error.

---

[API](https://skmtc.dev/chimoney/apis/chimoney-api-docs.md) - [All operations](https://skmtc.dev/chimoney/apis/chimoney-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/chimoney/apis/chimoney-api-docs/revisions/227751df36a0?raw)