Skip to main content
POST
/
tax
/
products
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"
}'
{
  "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"
}

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

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"