---
title: "Create a beneficiary"
method: POST
path: "/profile/beneficiaries/business/{businessID}"
---

# Create a beneficiary

`POST /profile/beneficiaries/business/{businessID}`

## Request

- Base URL: `https://sandboxapi.fincra.com`
- URL: `https://sandboxapi.fincra.com/profile/beneficiaries/business/{businessID}`
- Auth: API key in header `api-key`
- TypeScript: <https://skmtc.dev/fincra/apis/awesome-new-api/docs/profile/beneficiaries/business/:businessID/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint is used for creating a Beneficiary.

## Path parameters

- `businessID` string, required

## Request body

- object
  - `firstName` string, required: The first name or the company name
  - `lastName` string: The last name
  - `email` string: The email
  - `phoneNumber` string: The phone/mobile number the beneficiary can be contacted with
  - `accountHolderName` string, required: The name on the account
  - `bank` object: The banking institution
    - `name` string: The bank name
    - `code` string: The bank code
    - `sortCode` string: The sort code is a number which usually identifies both the bank and the branch where an account is held.
    - `swiftCode` string: A SWIFT code is a code used to identify the country, bank and branch that an account is registered to
    - `branch` string: A bank branch is a retail location of a banking corporation
    - `address` object: The bank address
      - `country` string: The code of country according to ISO 3166-1 alpha-2 codes
      - `state` string: The state
      - `zip` string: The zip/postal code
      - `city` string: The city name
      - `street` string: The street name
  - `address` object: The physical address of the beneficiary.
    - `country` string: The code of country according to ISO 3166-1 alpha-2 codes
    - `state` string: The state
    - `zip` string: The zip/postal code
    - `city` string: The city name
    - `street` string: The street name
  - `type` string, required: The value for this field is either corporate or indivdual
  - `currency` string, required: The currency
  - `paymentDestination` string, required: This is the type of account payments can be made to e.g bank account
  - `destinationAddress` string, required: The account number
  - `uniqueIdentifier` string: unique identifier for the beneficiary e.g 2,gh or anything

## Response `200`

200

- object

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/fincra/apis/awesome-new-api.md) - [All operations](https://skmtc.dev/fincra/apis/awesome-new-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fincra/apis/awesome-new-api/revisions/526b1509a02d?raw)