Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-26286592.7 KB

Create and categorize a new product

post/tax/products

Request body

reference_product_idstring required

The ID of the product

reference_product_namestring required

The name of the product

product_categorystring required

The category of the product

Example request

{
  "reference_product_id": "p-123456789",
  "reference_product_name": "Red Shoes",
  "product_category": "CLOTHING_GENERAL"
}

Response

Product creation response

objectstring

The type of object: tax.product.

reference_product_idstring

The ID of the created product

reference_product_namestring

The name of the created product

product_categorystring

The category of the created product

created_atnumber

Epoch datetime representing the date and time the product was created

updated_atnumber

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

testmodeboolean

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

Example response

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