KintsugiKintsugi
API Lab

Create a Product

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 LabSimulated
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.
1Create product
POST/v1/products
2Get product categories
GET/v1/products/categories

Browse the categories you can assign to a product.

3Get product by id
GET/v1/products/{product_id}
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

Related Resources