---
title: "POST /tax/customers"
method: POST
path: "/tax/customers"
---

# POST /tax/customers

`POST /tax/customers`

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

## Request body

- CustomerRequest
  - `name` string — The customer's name
  - `email` string, required — The customer's email
  - `is_tax_exempt` boolean — If true, all `POST /tax/calculations` sold to this customer will return $0 in tax owed. The default value is `false`.
  - `reference_customer_id` string — The ID of the customer in your system

## Response `200`

Customer creation response

- CustomerResponse
  - `id` string — The ID of the customer
  - `object` string — The type of object: `tax.customer`
  - `reference_customer_id` string — The ID of the customer in your system
  - `name` string — The name of the created customer
  - `email` string — The email of the created customer
  - `is_tax_exempt` boolean — If true, all `POST /tax/calculations` sold to this customer will return $0 in tax owed. The default value is `false`.

## Other responses

- `400` — Unexpected error

---

[API](https://skmtc.net/numeral-com/apis/numeral-api.md) · [All operations](https://skmtc.net/numeral-com/apis/numeral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral-com/numeral-api/versions/f0af51c3f9b9/schema)
