---
title: "Create Recipient"
method: POST
path: "/v1/recipients"
tags: ["public.recipients"]
---

# Create Recipient

`POST /v1/recipients`

Creates a saved payout recipient (bank account or crypto address). Crypto recipients support USDC, USDT, native SOL on Solana, and native BNB on BSC. Native recipients are used through the transfers API. Duplicate destinations are deduplicated by fingerprint. Requires an idempotency key.

## Headers

- `X-Idempotency-Key` string, required

## Request body

- CreateRecipientRequest
  - `bank_account` BankAccountInput
    - `account_name` string
    - `account_number` string, required
    - `bank_code` string, required
  - `crypto_address` CryptoAddressInput
    - `address` string, required
    - `asset` 'USDC' | 'USDT' | 'SOL' | 'BNB', required
    - `chain` string, required
  - `customer_id` string
  - `swift_bank_account` SWIFTBankAccountInput
    - `account_country` string, required
    - `account_owner_name` string, required
    - `account_owner_type` 'individual' | 'business', required
    - `address` RecipientAddressInput, required
      - `city` string, required
      - `country` string, required
      - `postal_code` string, required
      - `state` string
      - `street_line_1` string, required
      - `street_line_2` string
    - `bank_address` RecipientAddressInput, required
      - `city` string, required
      - `country` string, required
      - `postal_code` string, required
      - `state` string
      - `street_line_1` string, required
      - `street_line_2` string
    - `bank_name` string
    - `bic` string
    - `business_name` string
    - `category` 'client' | 'parent_company' | 'subsidiary' | 'supplier', required
    - `first_name` string
    - `iban` string, required
    - `last_name` string
    - `purpose_of_funds` string[], required
    - `short_business_description` string, required
  - `type` 'BANK_ACCOUNT' | 'CRYPTO_ADDRESS' | 'US_BANK_ACCOUNT' | 'SWIFT_BANK_ACCOUNT', required
  - `us_bank_account` USBankAccountInput
    - `account_number` string, required
    - `account_owner_name` string, required
    - `account_type` 'checking' | 'savings', required
    - `address` RecipientAddressInput, required
      - `city` string, required
      - `country` string, required
      - `postal_code` string, required
      - `state` string
      - `street_line_1` string, required
      - `street_line_2` string
    - `bank_name` string, required
    - `payout_scheme` 'ach' | 'wire' | 'rtp', required
    - `routing_number` string, required

## Response `201`

Created

- RecipientResponse
  - `bank_account` BankAccountResponse
    - `account_name` string
    - `account_number_last4` string
    - `bank_code` string
    - `bank_name` string
  - `created_at` string
  - `crypto_address` CryptoAddressResponse
    - `address` string
    - `asset` string
    - `chain` string
  - `first_name` string
  - `id` string
  - `last_name` string
  - `swift_bank_account` SWIFTBankAccountResponse
    - `account_country` string
    - `account_owner_name` string
    - `account_owner_type` string
    - `address` RecipientAddressInput
      - `city` string, required
      - `country` string, required
      - `postal_code` string, required
      - `state` string
      - `street_line_1` string, required
      - `street_line_2` string
    - `bank_address` RecipientAddressInput
      - `city` string, required
      - `country` string, required
      - `postal_code` string, required
      - `state` string
      - `street_line_1` string, required
      - `street_line_2` string
    - `bank_name` string
    - `bic` string
    - `business_name` string
    - `category` string
    - `first_name` string
    - `iban_last4` string
    - `last_name` string
    - `purpose_of_funds` string[]
    - `short_business_description` string
  - `type` string
  - `us_bank_account` USBankAccountResponse
    - `account_number_last4` string
    - `account_owner_name` string
    - `account_type` string
    - `address` RecipientAddressInput
      - `city` string, required
      - `country` string, required
      - `postal_code` string, required
      - `state` string
      - `street_line_1` string, required
      - `street_line_2` string
    - `bank_name` string
    - `payout_scheme` string
    - `routing_number` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `409` — Idempotency conflict
- `500` — Internal server error

---

[API](https://skmtc.dev/daya/apis/daya-external-api-public-api.md) · [All operations](https://skmtc.dev/daya/apis/daya-external-api-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/daya/daya-external-api-public-api/revisions/5fc72bf91a48/schema)