CatalogVariants
Create a product variant
Creates a variant under the specified product and returns the complete variant representation.
Path Parameters
productId*string
Identifier of the product.
Header Parameters
x-Store-Id?string
Store the request acts on. Not needed when the token is bound to a store.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://api.ecomiq.pe/api/v1/catalog/products/7204558912004322039/variants" \ -H "x-Store-Id: <store-id>" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "name": "Azul / M", "sku": "POL-001-AZ-M", "price": 89, "compareAtPrice": 99, "lowStockThreshold": 5, "allowBackorders": false, "trackInventory": true, "weight": 0.25, "unitOfMeasure": "kilogram", "barcode": "7751234567892", "isDefault": false, "isDigital": false, "options": { "Color": "Azul", "Talla": "M" } }'{ "id": "7204558912004325377", "storeId": "7204558912004325301", "productId": "7204558912004325302", "sellerId": "7204558912004325305", "packageId": null, "shippingProfileId": null, "productName": "Polo de algodón", "productDescription": "Polo de algodón pima para uso diario.", "productSlug": "polo-de-algodon", "productType": "product", "productIsDigital": false, "productTaxIncluded": true, "productStatus": "active", "productImage": "https://cdn.example.com/products/pol-001.jpg", "thumbnail": "https://cdn.example.com/products/pol-001-thumb.jpg", "brandId": null, "brandName": null, "categoryId": null, "categoryName": null, "tags": [ "ropa", "algodón" ], "name": "Azul / M", "sku": "POL-001-AZ-M", "barcode": "7751234567892", "status": "active", "isDigital": false, "allowBackorders": false, "onHand": 12, "committed": 2, "available": 10, "order": 1, "isDefault": false, "upc": null, "mpn": null, "countryOfOrigin": null, "hsCode": null, "price": 89, "compareAtPrice": 99, "costPrice": null, "currency": "PEN", "lowStockThreshold": 5, "weight": 0.25, "width": 30, "height": 2, "length": 40, "unitOfMeasure": "kilogram", "requiresShipping": true, "trackInventory": true, "images": [], "options": [], "inventories": [], "optionValues": { "Color": "Azul", "Talla": "M" }, "modifierGroups": [], "createdOn": "2026-07-15T15:30:00Z", "updatedOn": "2026-07-20T18:10:00Z"}