Back to Tool Reference
MCP

listing.create

Dispatch a draft-listing generation task for a product design.

EffectwritesReachesoutside VaybelScopelisting:writePlanStarter+CreditsmeteredRate limit10/minIdempotent

Parameters

design_idstringRequired

UUID of the completed product design to list.

channelstringRequired

Sales channel. One of "tiktok_shop", "etsy", "shopify".

genderstring

Optional. Required only when the underlying blank is unisex and you want to override the gender inferred from selected mockups. "mens" or "womens".

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
category"listing"
task_type"create_listing_draft"
messagestring

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

Request
json
{
  "name": "listing.create",
  "arguments": {
    "design_id": "a26c06d3-32dc-5e33-9f63-b5d453ede96a",
    "channel": "etsy"
  }
}