---
title: "Create Payout Destination"
method: POST
path: "/payout-destination"
---

# Create Payout Destination

`POST /payout-destination`

## Request body

- object
  - `account_id` string, required — This represents the id of the account you are making a payout from
  - `source_type` 'bank_account' | 'wallet_account', required
  - `label` string, required
  - `type` 'internal' | 'wire' | 'nip' | 'stablecoin' | 'mobile_money', required — Select the wire option for payouts to USD bank accounts, the NIP option for payouts to NGN bank accounts, internal for payouts to Graph wallet accounts, and stablecoin for payouts to an on-chain wallet address.
  - `wire_type` 'ach' | 'fedwire' | 'swift' — Required for USD payouts via wire.
  - `destination_account_id` string — This applies for making internal transfers to an account created on Graph
  - `destination_type` 'bank_account' | 'wallet_account' | 'address' | 'mobile_money'
  - `account_type` 'personal' | 'business' — Beneficiary's account type
  - `bank_code` string — Beneficiary bank code. ONLY required for NGN payouts
  - `account_number` string — Beneficiary's account number required for all payouts to a bank account.
  - `routing_number` string — Routing Number is required for domestic USD payouts (to US based banks) while SWIFT code is required for USD payouts to non-US based banks.
  - `beneficiary_name` string — Required for USD payouts
  - `beneficiary_address` object — Required for all wire payouts
    - `line1` string, required
    - `line2` string
    - `city` string, required
    - `state` string, required
    - `country` string, required — NOTE: Use the ISO Alpha 2 country code format to ensure accurate processing. e.g United States should be passed as 'US', Nigeria should be passed as 'NG' and so on.
    - `postal_code` string, required
  - `bank_name` string — Beneficiary bank information required for USD payout (both domestic and international).
  - `bank_address` object — Beneficiary bank information required for swift type wire payouts
    - `line1` string, required
    - `line2` string
    - `city` string, required
    - `state` string, required
    - `country` string, required — NOTE: Use the ISO Alpha 2 country code format to ensure accurate processing. e.g United States should be passed as 'US', Nigeria should be passed as 'NG' and so on.
    - `postal_code` string, required
  - `address_code` string — This should be the wallet address you are paying out to
  - `address_network` 'ERC20' | 'TRC20' | 'POL'
  - `currency` 'USDC' | 'USDT'
  - `operator_code` string — Required for mobile money payouts e.g "airtel-gh"
  - `country_code` string
  - `phone_number` string

## Response `201`

201

- union
  - object
    - `data` object
      - `id` string
      - `account_id` string
      - `destination_account_id` string
      - `label` string
      - `type` string
      - `wire_type` unknown
      - `beneficiary_name` string
      - `account_number` string
      - `account_type` string
      - `routing_number` string
      - `routing_type` string
      - `bank_name` string
      - `bank_address` object
        - `city` string
        - `country` string
        - `line1` string
        - `line2` string
        - `postal_code` string
        - `state` string
      - `beneficiary_address` object
      - `is_deleted` boolean
      - `created_at` string
      - `updated_at` string
    - `message` string
    - `meta` unknown
    - `status` string
  - object
    - `data` object
      - `id` string
      - `account_id` string
      - `destination_account_id` unknown
      - `source_type` string
      - `destination_type` string
      - `label` string
      - `type` string
      - `currency` string
      - `wire_type` unknown
      - `account_name` string
      - `account_number` string
      - `account_type` string
      - `routing_number` unknown
      - `routing_type` unknown
      - `bank_name` string
      - `bank_code` string
      - `bank_address` object
      - `beneficiary_name` unknown
      - `beneficiary_address` object
      - `is_deleted` boolean
      - `created_at` string
      - `updated_at` string
    - `message` string
    - `meta` unknown
    - `status` string
  - object
    - `data` object
      - `id` string
      - `account_id` string
      - `destination_account_id` unknown
      - `source_type` string
      - `destination_type` string
      - `label` string
      - `type` string
      - `currency` string
      - `wire_type` unknown
      - `address_code` string
      - `address_network` string
      - `account_name` unknown
      - `account_number` unknown
      - `account_type` unknown
      - `routing_number` unknown
      - `routing_type` unknown
      - `bank_id` unknown
      - `bank_name` unknown
      - `bank_code` unknown
      - `bank_address` unknown
      - `beneficiary_name` unknown
      - `beneficiary_address` unknown
      - `is_deleted` boolean
      - `created_at` string
      - `updated_at` string
    - `message` string
    - `meta` unknown
    - `status` string
  - object
    - `data` object
      - `id` string
      - `account_id` string
      - `destination_account_id` unknown
      - `source_type` string
      - `destination_type` string
      - `label` string
      - `type` string
      - `currency` string
      - `wire_type` unknown
      - `address_code` unknown
      - `address_network` unknown
      - `phone_number` string
      - `account_name` unknown
      - `account_number` unknown
      - `account_type` unknown
      - `routing_number` unknown
      - `routing_type` unknown
      - `bank_id` unknown
      - `bank_name` unknown
      - `bank_code` unknown
      - `operator_code` string
      - `operator_name` string
      - `operator_country` string
      - `bank_address` unknown
      - `beneficiary_name` unknown
      - `beneficiary_address` unknown
      - `beneficiary_id_number` unknown
      - `is_deleted` boolean
      - `created_at` string
      - `updated_at` string
    - `message` string
    - `meta` unknown
    - `status` string

---

[API](https://skmtc.net/useoval/apis/core-api.md) · [All operations](https://skmtc.net/useoval/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/useoval/core-api/versions/cb65d8f214c3/schema)