---
title: "Create Payouts Destination(s)"
method: POST
path: "/payouts/v1/payment/destinations"
tags: ["Payouts"]
---

# Create Payouts Destination(s)

`POST /payouts/v1/payment/destinations`

Create payment destinations for use with Payouts. Destinations created with Payouts create a corresponding beneficiary with your bank.

## Request body

- object[]
  - `bank_identifier` string — Uniquely identifies the bank of the benefeciary account
  - `name` string, required — The name of the legal entity associated with the account.
  - `iban` string, required — The IBAN of the account
  - `display_name` string — The friendly display name for the account.
  - `account_number` string — The account number for the account.
  - `swift_code` string — The SWIFT Code for the bank account - required for most international destinations
  - `ifsc` string — The IFSC number for the bank account - required for international destinations in India.
  - `sort_code` string — The Sort Code for the bank account - required for international destinations in the UK
  - `routing_number` string — The Routing Number for the bank account - required for international destinations in the US.
  - `transit_code` string — The Transit Number for the bank account - required for international destinations in Canada
  - `address` string, required — The address of the owner of the destination bank account has registered with the bank.
  - `branch_address` string — The address of the branch that holds the account - required for all beneficiaries outside of ARE. This should be a single string with commas separating lines.
  - `country` string, required — The country that the holding financial institution is located in as a 3 letter ISO code.
  - `city` string, required — The city that the holding financial institution is located in.
  - `customer_id` string — The associated Lean Customer
  - `currency_iso_code` string, required — The currency of the payee account
  - `postal_code` string — The postal code of the bank branch that holds the account

## Response `200`

- object
  - `add_benefeciary_task_id` string, uuid — The unique ID to track the destination creation request. This is useful for debugging
  - `destination_id` string — The unique identifier for the Payment Destination object.
  - `bank_identifier` string
  - `iban` string — IBAN of the destination account
  - `account_number` string — The account number for the account.
  - `display_name` string — The friendly display name for the account.
  - `status` 'CONFIRMED' | 'FAILED' — Specifies the status of the destination
  - `error_message` string — Error meesage received from the bank

---

[API](https://skmtc.net/leantech/apis/auth.md) · [All operations](https://skmtc.net/leantech/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leantech/auth/revisions/c2e46d54d886/schema)