Back to Tool Reference
MCP

listing.update

Partial update + push the diff to the listing's channel.

Effectoverwrites or deletesReachesoutside VaybelScopelisting:writePlanStarter+Rate limit20/min

Text fields (title / description / tags) are pushed to the marketplace. warehouse_id assigns a TikTok Shop warehouse to the listing locally (required before listing.publish on TikTok) — pick one from listing.list_warehouses. Image and video updates have to go through the channel patch service in a follow-up tool; until that lands, do not accept them here (otherwise local content drifts away from the live listing without anyone knowing).

Parameters

listing_idstringRequired

Parent listing UUID.

titlestring

New title.

descriptionstring

New description.

tagsstring[]

New tag list. Etsy/Shopify only — passing tags on a TikTok listing is a no-op.

warehouse_idstring

TikTok warehouse id to assign (TikTok Shop listings only; see listing.list_warehouses).

Returns

okboolean
updated_fieldsstring[]
Request
json
{
  "name": "listing.update",
  "arguments": {
    "listing_id": "328a1311-6524-54d1-861c-a3a338195ec4",
    "title": "Retro Sunset Palm Tee, Unisex Heavyweight Cotton"
  }
}