products_save
Create local SKUs or change them: one row per SKU, found by its code.
writeSellerSheet
Gate: approve — interactive: show the change (SellerSheet's preview first where one exists), wait for an explicit approve; autopilot: only when the seller's own words asked for this change; otherwise ask. A code that exists is changed, and only in the fields you send. A code that does not exist is created. A pack can be a SKU of its own: then its listing takes 1 of it, and its 1688 pairing says how many 1688 units make one. Or it is several of a single SKU, stated on the listing link. Decide before you create.
Call it
In an AI client (MCP)
{
"name": "products_save",
"arguments": {
"store": "myStore-US",
"skus": []
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/products_save \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","skus":[]}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
skusrequired | object[] | 1 to 50 rows. Each row: sku (required; letters, digits and . _ / + -, first a letter or digit, at most 100, unique ignoring case), name (required for a new SKU), spu (the product it belongs to; default: the SKU's own code), variant (attribute to value, for a product with variants), product_name, brand and category_path (used only when the row creates the product), and any SKU field: status, cost, cost_currency, supplier_name, supplier_url, moq, lead_time_days, unit, pieces, carton and package sizes and weights, gtin, hs_code, country_of_origin, customs names, declared value, notes, purchase_notes, extra. |
store | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. Optional: it only names the organization to work in when your key reaches more than one. Default: the key's own organization. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.rows— sku, result (created, updated, unchanged or refused), sku_id, and for a refused row error_code, message and field. data.created, data.updated, data.unchanged, data.refused: Counts.
Workflow
- products_search first, so a row does not recreate a SKU under another code. Then products_link_listings, and alibaba1688_pair_sku for what it is bought as.