NUnumeral-com

Create Customer

Changed on

Create a new customer

post/tax/customers

Request

  • Base URL
    https://api.numeralhq.com
  • URL
    https://api.numeralhq.com/tax/customers
  • Auth
    HTTP bearer

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": "cust_123456789",
  "object": "tax.customer",
  "reference_customer_id": "20506",
  "name": "Customer Name",
  "email": "customer@example.com",
  "is_tax_exempt": true
}

Changes

  • f4650eaed11fRevision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      api operation id createCustomer_v20260301 was added

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status