Add new products and variants

New products go through the same call as updates: a SKU the shop doesn't have yet is created.

• Connector: preview_catalog_update, then apply_catalog_update (permission catalog:write).
• API: POST /products/upsert.

Required fields for a new SKU#

Optional: description, usage_information (how to use or care for it), stock (the opening count on the shelf; it needs the stock:write permission as well as catalog:write), parent_sku (makes it a variant).

Example#

{
  "dry_run": true,
  "products": [
    { "sku": "TM-010", "name": { "th": "รถดับเพลิงโทมิก้า", "en": "Tomica fire engine" },
      "price": 189, "category": "Toys", "brand": "Tomica", "stock": 12 }
  ]
}

Variants#

A variant is a size, colour or other option of a main product. Create the main product and give each variant parent_sku. The main product may be created in the same request:

{
  "products": [
    { "sku": "SHIRT-01", "name": "เสื้อยืดลายแมว", "price": 290, "category": "Clothing", "brand": "Nichi" },
    { "sku": "SHIRT-01-M", "name": "เสื้อยืดลายแมว ไซซ์ M", "price": 290, "category": "Clothing", "brand": "Nichi", "parent_sku": "SHIRT-01", "stock": 20 },
    { "sku": "SHIRT-01-L", "name": "เสื้อยืดลายแมว ไซซ์ L", "price": 290, "category": "Clothing", "brand": "Nichi", "parent_sku": "SHIRT-01", "stock": 15 }
  ]
}

• parent_sku must name a main product on your SellerSideKick store, or one created in the same request. It can't be another variant or a product that exists only on a marketplace.
• stock and parent_sku are for new products only. Sending them for an existing SKU is an error row; change stock with Update stock counts.

Common error rows#

• Unknown category: map the sheet's category to one of the shop's names.
• The SKU exists only on a marketplace: add it to the SellerSideKick store from the dashboard first.
• The same SKU twice in one request: keep one row per SKU.
• Missing required field on a new SKU: add name, price, category and brand.

New products appear on the SellerSideKick store and the chat bot can recommend them. A new product's opening stock reaches a marketplace listing once a listing with the same SKU is linked to it.