Skip to main content
POST
/
contacts
Create Contact
curl --request POST \
  --url https://api.meow.com/v1/contacts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "nickname": "<string>",
  "email": "jsmith@example.com",
  "address": {
    "street_line_1": "<string>",
    "city": "<string>",
    "street_line_2": "<string>",
    "state": "<string>",
    "postal_code": "<string>"
  },
  "counterparty": {
    "name_on_account": "<string>",
    "nickname": "<string>",
    "ach": {
      "account_number": "<string>",
      "routing_number": "<string>",
      "address_on_account": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      }
    },
    "wire": {
      "account_number": "<string>",
      "routing_number": "<string>",
      "address_on_account": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      },
      "bank_address": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      },
      "bank_name": "<string>",
      "intermediary_bank": {
        "name": "<string>",
        "routing_number": "<string>",
        "address": {
          "street_line_1": "<string>",
          "city": "<string>",
          "postal_code": "<string>",
          "street_line_2": "<string>",
          "state": "<string>"
        }
      }
    },
    "check": {
      "address": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      },
      "created_time": "2023-11-07T05:31:56Z",
      "updated_time": "2023-11-07T05:31:56Z"
    },
    "tch": {
      "account_number": "<string>",
      "routing_number": "<string>",
      "address_on_account": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      }
    },
    "fednow": {
      "account_number": "<string>",
      "routing_number": "<string>",
      "address_on_account": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      }
    },
    "crnow": {
      "account_number": "<string>",
      "routing_number": "<string>",
      "address_on_account": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      }
    },
    "plaid_processor_token": "<string>",
    "email": "jsmith@example.com",
    "company_ids": [
      "<string>"
    ],
    "conduit_counterparty_profile": {
      "business_name": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "date_of_birth": "2023-12-25",
      "identification_number": "<string>"
    }
  },
  "crypto_address": {
    "address": "<string>"
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "nickname": "<string>",
  "payment_methods": {
    "ach": {
      "counterparty_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name_on_account": "<string>",
      "nickname": "<string>",
      "account_number": "<string>",
      "routing_number": "<string>",
      "address_on_account": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      }
    },
    "wire": {
      "counterparty_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name_on_account": "<string>",
      "nickname": "<string>",
      "bank_name": "<string>",
      "account_number": "<string>",
      "routing_number": "<string>",
      "beneficiary_address": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      },
      "bank_address": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      },
      "intermediary_bank": {
        "name": "<string>",
        "routing_number": "<string>",
        "address": {
          "street_line_1": "<string>",
          "city": "<string>",
          "postal_code": "<string>",
          "street_line_2": "<string>",
          "state": "<string>"
        }
      }
    },
    "check": {
      "counterparty_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name_on_account": "<string>",
      "nickname": "<string>",
      "mailing_address": {
        "street_line_1": "<string>",
        "city": "<string>",
        "postal_code": "<string>",
        "street_line_2": "<string>",
        "state": "<string>"
      }
    },
    "international": {
      "beneficiary_id": "<string>"
    },
    "crypto": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "destination_address": "<string>"
      }
    ],
    "static_memos": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "destination_address": "<string>"
      }
    ]
  },
  "supported_payment_methods": [],
  "email": "jsmith@example.com",
  "address": {
    "street_line_1": "<string>",
    "city": "<string>",
    "postal_code": "<string>",
    "street_line_2": "<string>",
    "state": "<string>"
  }
}

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

Banking (ACH, wire, or check) details. Provide either this or crypto_address.

​
crypto_address
CryptoAddressRequest · object | null

USDC crypto address. Provide either this or counterparty.

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
MeowApiAddress · 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