Create Products

Create and categorize a new product

POST /tax/products

cURL

cURL

curl --request POST \
  --url https://api.numeralhq.com/tax/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reference_product_id": "p-123456789",
  "reference_product_name": "Red Shoes",
  "product_category": "CLOTHING_GENERAL"
}
'

200

{
  "object": "tax.product",
  "reference_product_id": "p-20506",
  "reference_product_name": "Red Shoes",
  "product_category": "CLOTHING_GENERAL",
  "created_at": 1721694425,
  "updated_at": 1721694425,
  "testmode": "true"
}

Product Endpoint (2026-01-01)

Create and categorize a new product for tax calculation purposes.

Remember to include the X-API-Version: 2026-01-01 header in your request to use this API version.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

reference_product_id · string · required

The ID of the product

Example:

"p-123456789"

reference_product_name · string · required

The name of the product

Example:

"Red Shoes"

product_category · string · required

The category of the product

Example:

"CLOTHING_GENERAL"

Response

200

application/json

Product creation response

object · string

The type of object: tax.product.

Example:

"tax.product"

reference_product_id · string

The ID of the created product

Example:

"p-20506"

reference_product_name · string

The name of the created product

Example:

"Red Shoes"

product_category · string

The category of the created product

Example:

"CLOTHING_GENERAL"

created_at · number

Epoch datetime representing the date and time the product was created

Example:

1721694425

updated_at · number

Epoch datetime representing the date and time the product was last updated

Example:

1721694425

testmode · boolean

True if using a production API key. False if using a test API key.

Example:

"true"