# Create product

> POST /v1/products

Source: https://docs.trykintsugi.com/reference/create-product

API version: v1 (legacy API)

POST /v1/products

Create product

The Create Product API allows users to manually create a new product
    in the system. This includes specifying product details such as category,
    subcategory, and tax exemption status, etc. You can
    retrieve supported categories and subcategories from the
    [GET /products/categories endpoint](/reference/api/products/get-product-categories),
    or browse the full catalog with descriptions and examples in the
    [Product Categories guide](/docs/guides/product-categories).

    Idempotent on ``(organization_id, external_id, source)`` for connectionless
    creates (CP-4726): a re-POST of an existing identity returns ``200``. A live
    match is unchanged; a previously deleted match is revived (status returns to
    ``PENDING``). Use PUT to update fields.

Category: Products

Request body:
external_id (string, required) - A unique external identifier for the product.
name (string, required) - The name of the product.
description (string) - A description of the product.
status (ProductStatusEnum) - The approval status of the product.
  allowed values: APPROVED, PARTIALLY_APPROVED, PENDING, ARCHIVED
product_category (PublicProductCategoryEnum, required) - The high-level category of the product.
  allowed values: Physical, Digital, Misc, Services
product_subcategory (string, required) - Tax subcategory display label within the category (e.g. 'General Clothing'). Together with product_category it resolves to a product tax code; an unrecognized pair returns 400. List supported values from [GET /products/categories](/reference/api/products/get-product-categories).
tax_exempt (boolean, required) - Specifies whether the product is tax-exempt.
source (SourceEnum) - Indicates the source of the product.
  allowed values: BIGCOMMERCE, BESTBUY, BUNNY, CHARGEBEE, SHOPIFY, SHOPLINE, ECWID, STRIPE, AMAZON, TIKTOK, CUSTOM, UNKNOWN (and 69 more, see the reference page)

Response fields:
id (string, required)
external_id (string, required)
sku (string[], required)
code (string, required)
name (string, required)
description (string, required)
status (ProductStatusEnum, required)
  allowed values: APPROVED, PARTIALLY_APPROVED, PENDING, ARCHIVED
product_category (string, required) - Main category of the product.
        For example, Physical, Digital, etc. You can
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt