Create Product

Request

Create a Product

📌 Description

This endpoint allows you to create a new product in the fulfilment system. Each product must have a unique SKU, and essential details such as pricing, inventory tracking settings, and dimensions must be provided.

🔹 Use Cases

Adding a new product to the fulfilment system.
Defining product pricing and inventory tracking settings.
Configuring product dimensions for warehouse storage and shipping calculations.

Security

OAuth2

Bodyapplication/json

availability_statusinteger, (int64)(Current availability status of the product (1: available, 0: unavailable) )required

barcodestring(Product barcode (EAN, UPC, ISBN, etc.) )

batch_managementboolean(Whether batch management is enabled for this product. Omit to preserve; send true/false to set. )

clear_platform_priceboolean(ClearPlatformPrice, when true, removes an existing platform price. Send this to unset it: )

omitting platform_price alone no longer clears it, because the write layer now preserves the stored value so storefront syncs and re-cache jobs cannot silently wipe it (sc-29021). Sending a platform_price value still sets it; this flag only matters when no value is sent.

cost_pricenumber(Cost of acquiring/manufacturing the product )

country_code_of_originstring(ISO2 Country code where product was manufactured )

currencystring(types.Currency)required

Enum:"AED""SAR"

descriptionstring(Detailed description of the product )

dimensionsobject(types.RequestDimensions)

expiry_managementboolean(Whether expiry management is enabled for this product. Omit to preserve; send true/false to set. )

harmonized_system_codestring(Harmonized System Code for customs )

imagestring(URL of the product image )

inbound_expiry_threshold_daysinteger, (int64)(Minimum days of shelf life required when receiving inbound stock )

inventory_trackedboolean(Whether inventory levels are tracked )

namestring(Name of the product )

outbound_expiry_threshold_daysinteger, (int64)(Minimum days of shelf life required when picking outbound stock )

partner_product_idstring(Partner's unique identifier for the product )

platform_pricenumber(Platform price for international orders (overrides sales channel price when enabled) )

requires_shippingboolean(Indicates whether the product requires shipping services )

retail_pricenumber(Recommended retail price )

selling_pricenumber(Price at which the product is sold to customers )required

skustring(Unique Stock Keeping Unit identifier )required

statusstring(Product API types )

Enum:"active""archived""draft"

total_salesnumber(Total lifetime sales quantity of this product )

track_expiryboolean(Whether to track expiry dates for this product. Pointer so that omitting it preserves the )

stored value rather than resetting it to false — send true/false to change it (sc-29021).

typestring(Type of product (e.g. physical, digital) )

vendorstring(Name of the product vendor/manufacturer )

weightnumber(Weight of a single unit of the product )

weight_unitstring(Unit of weight measurement (kg or g) )

curl -i -X POST \
  https://developer-docs.quiqup.com/_mock/openapi/api/fulfilment/products \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "availability_status": 0,
    "barcode": "string",
    "batch_management": true,
    "clear_platform_price": true,
    "cost_price": 0,
    "country_code_of_origin": "string",
    "currency": "AED",
    "description": "string",
    "dimensions": {
      "height": 0,
      "length": 0,
      "unit": "string",
      "width": 0
    },
    "expiry_management": true,
    "harmonized_system_code": "string",
    "image": "string",
    "inbound_expiry_threshold_days": 0,
    "inventory_tracked": true,
    "name": "string",
    "outbound_expiry_threshold_days": 0,
    "partner_product_id": "string",
    "platform_price": 0,
    "requires_shipping": true,
    "retail_price": 0,
    "selling_price": 0,
    "sku": "string",
    "status": "active",
    "total_sales": 0,
    "track_expiry": true,
    "type": "string",
    "vendor": "string",
    "weight": 0,
    "weight_unit": "string"
  }'

Responses

Success response

Bodyapplication/json

availability_statusinteger, (int64)(Current total available quantity of the product )

barcodestring(Product barcode (EAN, UPC, ISBN, etc.) )

batch_managementboolean(Whether batch management is enabled for this product )

cost_pricenumber(Cost price of the product )

country_code_of_originstring(ISO2 Country code of origin (required). )

created_atstring, (date-time)(Creation timestamp )

currencystring(types.Currency)

Enum:"AED""SAR"

descriptionstring(Description of the product )

dimensionsobject(JSONType give a generic data type for json encoded data. )

expiry_managementboolean(Whether expiry management is enabled for this product )

harmonized_system_codestring(Harmonized System Code (HS Code) )

idstring(Unique identifier for the product )

imagestring(Images of the product )

inbound_expiry_threshold_daysinteger, (int64)(Minimum days of shelf life required when receiving inbound stock )

inventory_trackedboolean(If false means inventory can not be tracked/updated )

namestring(Name of the product )

outbound_expiry_threshold_daysinteger, (int64)(Minimum days of shelf life required when picking outbound stock )

partner_product_idstring(Partner's unique identifier for the product )

platform_pricenumber(Platform price for international orders (overrides sales channel price when enabled) )

requires_shippingboolean(Indicates whether the product requires shipping services (virtual products do not require shipping) )

retail_pricenumber(Retail price of the product )

selling_pricenumber(Selling price of the product )

skustring(Stock Keeping Unit )

statusstring(Product API types )

Enum:"active""archived""draft"

total_salesnumber(Total lifetime sales quantity of this product )

track_expiryboolean(Track expiry of the product, default to false )

typestring(Category of the product )

updated_atstring, (date-time)(Last update timestamp )

vendorstring(Vendor or brand name )