MCP

listing.publish

Dispatch the channel-specific publish task for a draft listing.

Effectoverwrites or deletesReachesoutside VaybelScopelisting:writePlanStarter+Rate limit5/minIdempotent

For TikTok Shop, a warehouse must be assigned on the listing first — today that's done in the dashboard (Listings → the listing → warehouse); publishing without one fails with a clear error. For Etsy/Shopify, the listing must be in DRAFT status.

Parameters

listing_idstringRequired

Parent listing UUID.

idempotency_keystring

Send the same key when retrying this exact call. A completed request replays for 24 hours without running or billing again.

callback_urlstring

An https URL that receives a signed completion event when the work finishes, so you can skip polling. See Webhooks.

Returns

handlestring

Opaque async handle. Pass to listing.get_generation.

status"pending"

channelstring

task_type"publish_listing_draft"

messagestring

Describes the listing.get_generation(..., wait_sec=...) contract.

Request

json

{
  "name": "listing.publish",
  "arguments": {
    "listing_id": "328a1311-6524-54d1-861c-a3a338195ec4"
  }
}