---
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 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.net/chimoney/apis/chimoney-api-docs.md) · [All operations](https://skmtc.net/chimoney/apis/chimoney-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chimoney/chimoney-api-docs/revisions/227751df36a0/schema)