# Add new products and variants

> Create products by SKU with names, price, category, brand and opening stock, and make sizes or colours variants of a main product.

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

| Field | Notes |
|---|---|
| `sku` | your product code, up to 100 characters |
| `name` | a string (Thai) or `{ "th": "…", "en": "…" }` |
| `price` | THB |
| `category` | a name from `list_categories` / `GET /categories` |
| `brand` | a new brand is added to the shop's list |

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

```json
{
  "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:

```json
{
  "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](https://docs.sellersidekick.ai/update-stock).

## 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.