Create a new ecommerce product or update an existing one, identified by the mandatory `id` field. When `updateEnabled` is `false` (the default), the endpoint inserts a new product and returns `201`; if the product ID already exists, a `400` error is returned. When `updateEnabled` is `true`, the endpoint performs an upsert, returning `201` for a new product or `204` for an update. The `name` field is mandatory for creation but optional for updates. Product images are downloaded, validated (max 5 MB, formats: jpeg, jpg, png, bmp, gif, webp), and re-hosted on S3. The `metaInfo` object supports up to 20 keys with a cumulative size limit of approximately 1000 KB.
Request
Values to create/update a product
idstringRequiredformat: "string"
Product ID for which you requested the details
namestringRequired
Mandatory in case of creation. Name of the product, as displayed in the shop
brandstringOptional<=128 characters
Brand of the product
categorieslist of stringsOptional
Category ID-s of the product
deletedAtstringOptional
UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) of the product deleted from the shop’s database
descriptionstringOptional<=3000 characters
Description of the product
imageUrlstringOptionalformat: "string"
Absolute URL to the cover image of the product
isDeletedbooleanOptional
product deleted from the shop's database
metaInfomap from strings to strings or integersOptional
Meta data of product such as description, vendor, producer, stock level. The total characters of cumulative metaInfo shall not exceed 20000 characters.
parentIdstringOptionalformat: "string"
Parent product id of the product
pricedoubleOptional
Price of the product
skustringOptionalformat: "string"
Product identifier from the shop
stockdoubleOptional
Current stock value of the product from the shop's database
updateEnabledbooleanOptionalDefaults to false
Facilitate to update the existing product in the same request (updateEnabled = true)
urlstringOptionalformat: "string"
URL to the product
Response
Product created
idstring
ID of the product when a new product is created