Create customer

POST

customers

{
  "corporation_id": "corp_123",
  "name": "Acme Corporation",
  "email": "contact@acme.com",
  "external_id": "ext_456",
  "business_identification_number": "12-3456789",
  "shipping_address": {
    "line1": "123 Main St",
    "line2": "Suite 100",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US"
  }
}

{
  "id": "cust_789",
  "name": "Acme Corporation",
  "email": "contact@acme.com",
  "corporation_id": "corp_123",
  "created_at": 1706000000
}

Creates a new customer for a corporation.

Request body

string

required

The unique identifier for the corporation

string

required

Customer name (minimum 3 characters)

string

Customer email address (must be valid email format)

string

External identifier for the customer from your system

string

A tax or business registration number for the customer (e.g., VAT ID, EIN, GST number). Used to identify the customer’s tax status in applicable jurisdictions.

object

Customer’s shipping address

Show shipping_address properties

string

Street address line 1

string

Street address line 2

string

City name

string

State or province code

string

Postal or ZIP code

string

ISO 3166 2-letter country code

Response

string

Unique identifier for the customer

string

Customer name

string

Customer email address

string

The corporation ID this customer belongs to

int64

Unix timestamp of when the customer was created

string

Source platform identifier (if applicable)

string

Source platform name (if applicable)

string

The customer’s tax or business registration number, if provided

{
  "corporation_id": "corp_123",
  "name": "Acme Corporation",
  "email": "contact@acme.com",
  "external_id": "ext_456",
  "business_identification_number": "12-3456789",
  "shipping_address": {
    "line1": "123 Main St",
    "line2": "Suite 100",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US"
  }
}

{
  "id": "cust_789",
  "name": "Acme Corporation",
  "email": "contact@acme.com",
  "corporation_id": "corp_123",
  "created_at": 1706000000
}

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

A display name for this customer.

Minimum string length: 3

Example:

"John Doe"

corporation_id

string

required

The unique identifier for a corporation this customer belongs to.

Example:

"b6d009b0-d174-463f-b030-94643c28e209"

string<email>

Email address of the customer.

shipping_address

object

Address object. Only country is required at the schema level. All other field requirements (including postal_code and state) vary by country — use the /address-requirements endpoint to check which fields are REQUIRED, OPTIONAL, or IGNORED for a given country. When provided, postal codes and state codes are validated against country-specific formats and allowed values.

Show child attributes

external_id

string

External identifier for the customer.

business_identification_number

string

Business identification number for the customer (e.g., tax ID, VAT number, or EIN).

Response

Information about the created customer

data

object

Show child attributes

message

string

Example:

"Successfully created customer."

Get Started

Registrations

Registrations V2

Corporations

Tax Calculations

Transactions

Address Requirements

Registration Thresholds

Products

Customers

Exemption Certificates

Exemptions

Files

Credentials

Locations

Filings

Webhooks

Request body

Response

Authorizations

Body

Response

​Request body

​Response

Authorizations

Body

Response

Request body

Response