---
title: "Create a beneficiary"
method: POST
path: "/beneficiaries"
---

# Create a beneficiary

`POST /beneficiaries`

## Request

- Base URL: `https://api.sandbox.waza.co/v2`
- URL: `https://api.sandbox.waza.co/v2/beneficiaries`
- Auth: API key in header `waza-x-key`

## Headers

- `waza-x-key` string

## Request body

- object
  - `type` string, required
  - `country` string, required
  - `email` string
  - `phone` string
  - `client_reference` string
  - `address` string, required
  - `bank` object, required
    - `code` string
    - `name` string
    - `account_number` string
    - `address` string
  - `currency` string, required
  - `business_name` string, required
  - `intermediary_bank` object
    - `code` string
    - `name` string
    - `account_number` string
    - `address` string
  - `tag` string

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `type` string
    - `country` string
    - `currency` string
    - `phone` string
    - `address` string
    - `email` string
    - `business_name` string
    - `first_name` unknown
    - `last_name` unknown
    - `created_date` string
    - `updated_date` string
    - `client_reference` string
    - `bank` object
      - `name` string
      - `account_number` string
      - `address` string
      - `code` string
    - `tag` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/waza/apis/b2b-payments-api.md) - [All operations](https://skmtc.dev/waza/apis/b2b-payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/waza/apis/b2b-payments-api/revisions/7d4685fefb9f?raw)