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)

tools/call
{
  "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

NameTypeDescription
skusrequiredobject[]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.
storestringthe 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.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude