curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/products' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"brand": "AudioTech",
"cost_price": "75.00",
"currency": "USD",
"description": "Premium over-ear wireless headphones with active noise cancellation, 30-hour battery life, and premium sound quality.",
"dimensions_cm": "20x18x8",
"image_url": "https://cdn.example.com/products/wbh-blk-001.jpg",
"is_active": true,
"is_digital": false,
"manufacturer": "AudioTech Inc.",
"meta_description": "Shop premium wireless Bluetooth headphones with ANC and 30-hour battery life.",
"meta_title": "Wireless Bluetooth Headphones | AudioTech",
"msrp": "199.99",
"name": "Wireless Bluetooth Headphones",
"price": "149.99",
"reorder_point": 25,
"sku": "WBH-BLK-001",
"tags": "electronics,audio,headphones,wireless,bluetooth",
"tax_rate": "0.08",
"weight_kg": "0.35"
}'
{
"data": {
"brand": "AudioTech",
"cost_price": "75.00",
"created_at": "2024-12-09T10:30:00Z",
"currency": "USD",
"description": "Premium over-ear wireless headphones with active noise cancellation.",
"dimensions_cm": "20x18x8",
"id": "550e8400-e29b-41d4-a716-446655440000",
"image_url": "https://cdn.example.com/products/wbh-blk-001.jpg",
"is_active": true,
"is_digital": false,
"manufacturer": "AudioTech Inc.",
"meta_description": "Shop premium wireless Bluetooth headphones.",
"meta_title": "Wireless Bluetooth Headphones | AudioTech",
"msrp": "199.99",
"name": "Wireless Bluetooth Headphones",
"price": "149.99",
"reorder_point": 25,
"sku": "WBH-BLK-001",
"tags": "electronics,audio,headphones,wireless",
"tax_rate": "0.08",
"updated_at": "2024-12-09T14:45:00Z",
"weight_kg": "0.35"
},
"errors": [
"string"
],
"message": "Two-person tent, green — replacement for damaged pole set.",
"meta": {
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z"
},
"success": true
}
Create a new product
Create a new product
POST
/
api
/
v1
/
products
curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/products' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"brand": "AudioTech",
"cost_price": "75.00",
"currency": "USD",
"description": "Premium over-ear wireless headphones with active noise cancellation, 30-hour battery life, and premium sound quality.",
"dimensions_cm": "20x18x8",
"image_url": "https://cdn.example.com/products/wbh-blk-001.jpg",
"is_active": true,
"is_digital": false,
"manufacturer": "AudioTech Inc.",
"meta_description": "Shop premium wireless Bluetooth headphones with ANC and 30-hour battery life.",
"meta_title": "Wireless Bluetooth Headphones | AudioTech",
"msrp": "199.99",
"name": "Wireless Bluetooth Headphones",
"price": "149.99",
"reorder_point": 25,
"sku": "WBH-BLK-001",
"tags": "electronics,audio,headphones,wireless,bluetooth",
"tax_rate": "0.08",
"weight_kg": "0.35"
}'
{
"data": {
"brand": "AudioTech",
"cost_price": "75.00",
"created_at": "2024-12-09T10:30:00Z",
"currency": "USD",
"description": "Premium over-ear wireless headphones with active noise cancellation.",
"dimensions_cm": "20x18x8",
"id": "550e8400-e29b-41d4-a716-446655440000",
"image_url": "https://cdn.example.com/products/wbh-blk-001.jpg",
"is_active": true,
"is_digital": false,
"manufacturer": "AudioTech Inc.",
"meta_description": "Shop premium wireless Bluetooth headphones.",
"meta_title": "Wireless Bluetooth Headphones | AudioTech",
"msrp": "199.99",
"name": "Wireless Bluetooth Headphones",
"price": "149.99",
"reorder_point": 25,
"sku": "WBH-BLK-001",
"tags": "electronics,audio,headphones,wireless",
"tax_rate": "0.08",
"updated_at": "2024-12-09T14:45:00Z",
"weight_kg": "0.35"
},
"errors": [
"string"
],
"message": "Two-person tent, green — replacement for damaged pole set.",
"meta": {
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z"
},
"success": true
}
Request body
CreateProductRequest
string,null
Brand name
string,null
Cost price (for profit calculation)
string,null
Currency code (ISO 4217, 3 characters)
string,null
Product description (max 2000 characters)
string,null
Dimensions in centimeters (LxWxH format)
string,null
Main product image URL
boolean,null
Whether the product is available for purchase
boolean,null
Whether this is a digital/downloadable product
string,null
Manufacturer name
string,null
SEO meta description
string,null
SEO meta title
string,null
Manufacturer’s suggested retail price
string
required
Product display name
string,null
Sale price
integer,null (int32)
Inventory reorder point threshold
string
required
Stock keeping unit (unique identifier)
string,null
Comma-separated tags for categorization
string,null
Tax rate as decimal
string,null
Product weight in kilograms
Response
ApiResponse_ProductResponse
object
Show data
Show data
string,null
Brand name
string,null
Cost price
string (date-time)
required
Creation timestamp
string
required
Currency code (ISO 4217)
string,null
Product description
string,null
Dimensions in centimeters
string (uuid)
required
Product UUID
string,null
Main product image URL
boolean
required
Whether product is available for purchase
boolean
required
Whether this is a digital/downloadable product
string,null
Manufacturer name
string,null
SEO meta description
string,null
SEO meta title
string,null
MSRP
string
required
Product display name
string
required
Sale price
integer,null (int32)
Reorder point threshold
string
required
Stock keeping unit
string,null
Comma-separated tags
string,null
Tax rate
string,null (date-time)
Last update timestamp
string,null
Product weight in kilograms
array,null
string,null
boolean
required
Status codes
| Code | Meaning |
|---|---|
201 | Product created |
400 | Invalid payload |
401 | Unauthorized |
403 | Forbidden |
curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/products' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"brand": "AudioTech",
"cost_price": "75.00",
"currency": "USD",
"description": "Premium over-ear wireless headphones with active noise cancellation, 30-hour battery life, and premium sound quality.",
"dimensions_cm": "20x18x8",
"image_url": "https://cdn.example.com/products/wbh-blk-001.jpg",
"is_active": true,
"is_digital": false,
"manufacturer": "AudioTech Inc.",
"meta_description": "Shop premium wireless Bluetooth headphones with ANC and 30-hour battery life.",
"meta_title": "Wireless Bluetooth Headphones | AudioTech",
"msrp": "199.99",
"name": "Wireless Bluetooth Headphones",
"price": "149.99",
"reorder_point": 25,
"sku": "WBH-BLK-001",
"tags": "electronics,audio,headphones,wireless,bluetooth",
"tax_rate": "0.08",
"weight_kg": "0.35"
}'
{
"data": {
"brand": "AudioTech",
"cost_price": "75.00",
"created_at": "2024-12-09T10:30:00Z",
"currency": "USD",
"description": "Premium over-ear wireless headphones with active noise cancellation.",
"dimensions_cm": "20x18x8",
"id": "550e8400-e29b-41d4-a716-446655440000",
"image_url": "https://cdn.example.com/products/wbh-blk-001.jpg",
"is_active": true,
"is_digital": false,
"manufacturer": "AudioTech Inc.",
"meta_description": "Shop premium wireless Bluetooth headphones.",
"meta_title": "Wireless Bluetooth Headphones | AudioTech",
"msrp": "199.99",
"name": "Wireless Bluetooth Headphones",
"price": "149.99",
"reorder_point": 25,
"sku": "WBH-BLK-001",
"tags": "electronics,audio,headphones,wireless",
"tax_rate": "0.08",
"updated_at": "2024-12-09T14:45:00Z",
"weight_kg": "0.35"
},
"errors": [
"string"
],
"message": "Two-person tent, green — replacement for damaged pole set.",
"meta": {
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z"
},
"success": true
}
Last modified on August 31, 2026