# Create a Product > Interactive walkthrough to create products using the Kintsugi API Source: https://docs.trykintsugi.com/docs/recipes/managing-products ## Overview Products in Kintsugi represent the items you sell. Each product needs proper tax classification (category and subcategory) to ensure accurate tax calculations. This endpoint creates a new product record that will be used for tax calculations in transactions. ## When to Use Product catalog setup: Create products when setting up your integration New product launches: Add new products as you expand your catalog Tax classification: Ensure products have proper tax categories for accurate calculations Manual product management: Create products outside of automated syncs ## Authentication This endpoint requires two headers: x-api-key: Your API key x-organization-id: Your organization ID Both headers are required for authentication. You can find your API key and organization ID in your Kintsugi dashboard. ## Try It Out API Lab Simulated Run all Reset Share Copy cURL Postman Runs in a simulated sandbox. Responses are generated from the API schema so you can explore each call safely; they never reach the live API, so the values are illustrative. 1 Create product POST /v1/products { "external_id": "prod_001", "name": "T-shirts", "description": "Common items of everyday wearing apparel designed for human use, covering a wide variety of non-specialized garments.", "status": "APPROVED", "product_category": "Physical", "product_subcategory": "General Clothing", "tax_exempt": false, "source": "BIGCOMMERCE" } { "external_id": "prod_001", "name": "T-shirts", "description": "Common items of everyday wearing apparel designed for human use, covering a wide variety of non-specialized garments.", "status": "APPROVED", "product_category": "Physical", "product_subcategory": "General Clothing", "tax_exempt": false, "source": "BIGCOMMERCE" } Run 2 Get product categories GET /v1/products/categories Browse the categories you can assign to a product. Run 3 Get product by id GET /v1/products/{product_id} Run Run the previous step to fill the path. ## Required Fields external_id: Your internal product identifier (must be unique within your organization) name: Name of the product product_category: Product category (see Get Product Categories) product_subcategory: Product subcategory (see Get Product Categories) ## Common Use Cases Basic Product Creation Create a product with minimal required fields: { "external_id": "SKU-12345", "name": "Example Product", "product_category": "Physical", "product_subcategory": "General Physical" } Product with Full Details Include additional product information: { "external_id": "PROD-ABC-123", "name": "Premium Wireless Headphones", "product_category": "Physical", "product_subcategory": "General Physical", "description": "High-quality wireless headphones with noise cancellation", "source": "API" } ## Response Fields id: Kintsugi's unique product identifier external_id: Your product identifier name: Product name product_category: Product category product_subcategory: Product subcategory status: Product status (ACTIVE, ARCHIVED) tax_exempt: Whether the product is tax exempt source: Source of the product record ## Product Categories Before creating products, you may want to fetch available categories and subcategories using the Get Product Categories endpoint. Categories determine how products are taxed across different jurisdictions. Product categories align with tax regulations across jurisdictions. Choose the most specific category and subcategory that matches your product to ensure accurate tax calculations. ## Next Steps Get Product Categories - View all available categories and subcategories Get Products - List and search your products Get Product by ID - Retrieve a specific product Update Product - Modify product details Product & Customer Records Guide - Learn more about product management ## Related Resources Products API Reference Getting Started Support --- Index of every page: https://docs.trykintsugi.com/llms.txt