Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-13153492.5 KB

Create a new customer, and optionally mark them as tax exempt

post/tax/customers

Request body

namestring

The customer's name

emailstring required

The customer's email

is_tax_exemptboolean

If true, all POST /tax/calculations sold to this customer will return $0 in tax owed. The default value is false.

reference_customer_idstring

The ID of the customer in your system

Example request

{
  "name": "Customer Name",
  "email": "customer@example.com",
  "is_tax_exempt": true,
  "reference_customer_id": "20506"
}

Response

Customer creation response

idstring

The ID of the customer

objectstring

The type of object: tax.customer

reference_customer_idstring

The ID of the customer in your system

namestring

The name of the created customer

emailstring

The email of the created customer

is_tax_exemptboolean

If true, all POST /tax/calculations sold to this customer will return $0 in tax owed. The default value is false.

Example response

{
  "id": "cus_123456789",
  "object": "tax.customer",
  "reference_customer_id": "20506",
  "name": "Customer Name",
  "email": "customer@example.com",
  "is_tax_exempt": true
}