Skip to main content
POST
Create Contact

Authorizations

x-api-key
string
header
required

Your Meow API key, sent in the x-api-key header for authentication.

Headers

x-entity-id
string<uuid>

Optional entity_id to scope requests to a specific entity.

Body

application/json
nickname
string
required

A nickname or display name for the contact (1-300 characters).

Required string length: 1 - 300
email
string<email> | null

The email address of the contact.

address
MeowAddressRequest · object | null

Optional postal address stored alongside ACH, wire, or check contacts.

counterparty
CounterpartyDetailsRequest · object | null

Domestic banking (ACH, wire, or check) details. Provide exactly one of this, international, or crypto_address.

international
CustomerApiInternationalDetailsRequest · object | null

International payment details (IBAN, BIC/SWIFT, or a local routing code). Provide exactly one of this, counterparty, or crypto_address.

crypto_address
CryptoAddressRequest · object | null

USDC crypto address. Provide exactly one of this, counterparty, or international.

Response

Successful Response

id
string<uuid>
required

The unique identifier of the contact.

nickname
string
required

A nickname or display name for the contact.

Required string length: 1 - 400
payment_methods
CustomerApiPaymentMethods · object
required

Payment methods associated with this contact.

supported_payment_methods
enum<string>[]
required

List of payment methods supported by this contact.

Available options:
ach,
wire,
check,
international,
crypto,
static_memo
email
string<email> | null

The email address of the contact.

address
AddressResponse · object | null

The physical address of the contact.

last_payment_reason
enum<string> | null

Payment reason recorded on the most recent payment to this contact.

Available options:
audio_visual_services,
bill_payment,
business_expenses,
construction,
donation_charitable_contribution,
education_training,
family_support,
freight,
goods_purchased,
investment_capital,
investment_proceeds,
living_expenses,
loan_credit_repayment,
medical_services,
pension,
personal_remittance,
professional_business_services,
real_estate,
taxes,
technical_services,
transfer_to_own_account,
travel,
wages_salary,
other_services