This endpoint creates a new product and automatically initializes inventory tracking. Products support multiple variants and can be associated with suppliers and categories.
Authentication
This endpoint requires a valid API key withproducts:write
permissions.
Request Body
Product name for display
Unique stock keeping unit (SKU) identifier
Detailed product description
Product category (e.g., “Electronics”, “Clothing”, “Home & Garden”)
Brand or manufacturer name
Pricing information
Cost information for margin calculations
Inventory settings
Product dimensions for shipping calculations
Product variants (e.g., different sizes, colors)
Product images
Supplier information
Additional custom fields as key-value pairs
Array of string tags for categorization and search
Product status: “active”, “draft”, or “archived” (default: “active”)
Response
Unique product identifier
Always “product”
ISO 8601 timestamp of creation
ISO 8601 timestamp of last update
Product name
Product SKU
Product status
Array of product variants with their IDs
Summary of inventory across all variants