Create Recipient

post

https://api.1money.com/v1/customers/{customer_id}/recipients

Create a new recipient (third-party counterparty) for a customer.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Functionality:

Registers a new recipient that can receive fiat or crypto payments
Supports both individual and company recipient types
Automatically assigns a unique recipient_id upon successful creation

Required Fields:

relationship: Recipient's relationship to the customer (e.g., VENDOR, EMPLOYEE)
address: Recipient address details

Idempotency & Duplicate Detection:

Required: Include an Idempotency-Key header with a unique UUID for each new recipient creation

Path Params

customer_id

string

required

Unique identifier of the customer

Body Params

Request body for creating a recipient

business_type

string

enum

required

Recipient type: INDIVIDUAL or COMPANY

Allowed:

first_name

string | null

First name (required for INDIVIDUAL)

last_name

string | null

Last name (required for INDIVIDUAL)

company_name

string | null

Company name (required for COMPANY)

nickname

string | null

Display name for the recipient

string | null

Email address

mobile_code

string | null

Mobile country code (e.g., +1)

mobile_num

string | null

Mobile number

relationship

string

enum

required

Relationship to the customer (required for bank account operations).
Supported: EMPLOYEE, CONTRACTOR, VENDOR, SUBSIDIARY, MERCHANT, CUSTOMER, LANDLORD, FAMILY, OTHER

address

object

required

Recipient address (required for bank account operations)

bank_accounts

array of objects | null

Bank accounts to create with the recipient (reuses ExternalAccountRequest)

bank_accounts

Headers

Idempotency-Key

string

required

UUID v4 for idempotent requests

Responses

201Recipient created successfully

400Validation failed - Invalid request body

401Authentication failed

405Method not allowed

409Conflict - Recipient with same idempotency key already exists

500Internal server error