Skip to main content
POST
/
v1
/
customers
Create Customer
curl --request POST \
  --url https://api.monk.com/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corp",
  "legalName": "Acme Corporation Inc.",
  "tags": [
    "enterprise"
  ],
  "contacts": [
    {
      "name": "John Doe",
      "email": "john@acme.com",
      "roles": [
        "accounts_payable"
      ],
      "emailRecipientType": "to"
    }
  ],
  "billingAddress": {
    "address1": "123 Main St",
    "city": "San Francisco",
    "region": "CA",
    "postalCode": "94105",
    "country": "US"
  }
}
'
{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Acme Corp",
    "legalName": "Acme Corporation Inc.",
    "tags": [
      "enterprise"
    ],
    "isPaused": false,
    "pausedAt": null,
    "metadata": {
      "externalCustomerId": "my-crm-id-123",
      "externalCompanyIds": []
    },
    "createdAt": "2024-01-01T00:00:00.000Z",
    "updatedAt": "2024-01-01T00:00:00.000Z"
  }
}
Scope: customers:write

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Display name

contacts
object[]
required

At least one contact is required. Each contact must have an email and at least one role.

Minimum array length: 1

Legal/registered business name

externalCustomerId
string

Your own external customer ID

paymentProviderId
string

Payment provider customer ID (e.g. Stripe cus_xxx). Requires provider.

provider
enum<string>

Payment provider. Requires paymentProviderId.

Available options:
stripe
tags
string[]
billingAddress
object

Billing address for tax calculation. Required when your organization has sales tax (Anrok) enabled.

paymentMethodId
string

Stripe Payment Method ID (pm_xxx). Sets the customer's default payment method. Requires paymentMethodType.

paymentMethodType
enum<string>

Type of payment method. Required when paymentMethodId is provided.

Available options:
card,
us_bank_account

Response

Customer created

data
object