---
title: "Create Beneficiary"
method: POST
path: "/v4/accounts"
tags: ["Beneficiaries"]
---

# Create Beneficiary

`POST /v4/accounts`

Create a new beneficiary

## Request body

- CreateBeneficiaryRequest
  - `counterparty_id` integer, required
  - `cid` string, required
  - `name` string, required
  - `account_type` 'Bank' | 'Wallet', required
  - `ccy` string — Account currency - ISO Code 3
  - `host_name` string — Bank name
  - `host_hub` string — Bank sort code
  - `host_location` string — Bank address
  - `host_country` string, required — Account country - ISO Code 2
  - `node_name` string — Account name
  - `node_address` string — Account number
  - `node_location_line_1` string — Beneficiary address line 1 - Mandatory for CHAPS payments
  - `node_location_line_2` string — Beneficiary address line 2
  - `node_location_line_3` string — Beneficiary address line 3
  - `node_location_city` string — Beneficiary address city
  - `node_location_region` string — Beneficiary address region
  - `node_location_postcode` string — Beneficiary address postcode
  - `node_country` string — ISO Code 2 letters
  - `node_type` 'individual' | 'corporate', required
  - `iban` string
  - `bic` string
  - `account_label` string — Name - CCY
  - `payment_type` string
  - `email` string — Beneficiary email address
  - `bcb_controlled` integer, required — This is always 1
  - `settlement_reference` string
  - `is_beneficiary` integer, required — This is always 1

## Response `200`

Success

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/bcb/apis/payments-api.md) · [All operations](https://skmtc.net/bcb/apis/payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bcb/payments-api/revisions/7559660d5268/schema)