curl -X POST https://api.numeralhq.com/tax/customers/cust_6126acaf-7379-411a-8ada-00005bac0715 \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"is_tax_exempt": true
}'
curl -X POST https://api.numeralhq.com/tax/customers/20506 \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"name": "New Customer Name",
"email": "new.email@example.com"
}'
{
"id": "cust_6126acaf-7379-411a-8ada-00005bac0715",
"object": "tax.customer",
"reference_customer_id": "20506",
"name": "New Customer Name",
"email": "new.email@example.com",
"is_tax_exempt": true
}
{
"error": {
"error_code": "duplicate_customer",
"error_message": "Customer already exists.",
"error_meta": {
"id": "cust_1234567890abcdef",
"reference_customer_id": "20507",
"email": "new.email@example.com"
}
}
}
{
"error": {
"error_code": "customer_not_found",
"error_message": "Customer with id cust_9876543210abcdef not found"
}
}
Update Customer
Update an existing customer’s information
POST
/
tax
/
customers
/
{customer_id}
curl -X POST https://api.numeralhq.com/tax/customers/cust_6126acaf-7379-411a-8ada-00005bac0715 \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"is_tax_exempt": true
}'
curl -X POST https://api.numeralhq.com/tax/customers/20506 \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"name": "New Customer Name",
"email": "new.email@example.com"
}'
{
"id": "cust_6126acaf-7379-411a-8ada-00005bac0715",
"object": "tax.customer",
"reference_customer_id": "20506",
"name": "New Customer Name",
"email": "new.email@example.com",
"is_tax_exempt": true
}
{
"error": {
"error_code": "duplicate_customer",
"error_message": "Customer already exists.",
"error_meta": {
"id": "cust_1234567890abcdef",
"reference_customer_id": "20507",
"email": "new.email@example.com"
}
}
}
{
"error": {
"error_code": "customer_not_found",
"error_message": "Customer with id cust_9876543210abcdef not found"
}
}
Update Customer Endpoint (2024-09-01)
Update an existing customer’sname, email, is_tax_exempt status, or reference_customer_id. All fields are optional, but at least one must be provided. Only the fields you include are changed; everything else is left as is.
The
customer_id path parameter accepts either the Numeral customer ID (cust_xxx) or your own reference_customer_id. No id_type query parameter is needed.Behavior
emailandreference_customer_idmust be unique across your customers. If another customer already uses the new value, the request fails withduplicate_customer. The conflicting customer’sid,reference_customer_id, andemailare returned inerror_meta.emailmust be a valid email address, otherwise the request fails withinvalid_email.- Setting
is_tax_exempttotruemeans all futurePOST /tax/calculationsfor this customer return $0 in tax owed. Setting it tofalseremoves the exemption. - If every provided value matches what is already stored, nothing is written and the current customer is returned with a
200. - Deleted customers cannot be updated. The request fails with
customer_not_found. - If the customer’s buyer record has been deleted in Numeral’s Exemption Certificate Manager, setting
is_tax_exempttotrueis rejected withinvalid_request.
curl -X POST https://api.numeralhq.com/tax/customers/cust_6126acaf-7379-411a-8ada-00005bac0715 \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"is_tax_exempt": true
}'
curl -X POST https://api.numeralhq.com/tax/customers/20506 \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"name": "New Customer Name",
"email": "new.email@example.com"
}'
{
"id": "cust_6126acaf-7379-411a-8ada-00005bac0715",
"object": "tax.customer",
"reference_customer_id": "20506",
"name": "New Customer Name",
"email": "new.email@example.com",
"is_tax_exempt": true
}
{
"error": {
"error_code": "duplicate_customer",
"error_message": "Customer already exists.",
"error_meta": {
"id": "cust_1234567890abcdef",
"reference_customer_id": "20507",
"email": "new.email@example.com"
}
}
}
{
"error": {
"error_code": "customer_not_found",
"error_message": "Customer with id cust_9876543210abcdef not found"
}
}
Authorizations
Path Parameters
Body
application/json
Request body for updating a customer. All fields are optional, but at least one must be provided.
Response
The updated customer