Preview Launch
POST/api/advertising/launch/preview
Builds a launch without writing anything: gates every product, builds the campaigns, ad groups, keywords and targets each eligible product would get, and splits eligible products into waves.
advertising:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Large previews run in the background. When the request names more distinct products than the tenant's background-preview threshold (50 by default), nothing is built inline: the call returns 202 with data.queued: true and data.tracked_job_log_id, the ID of the background job building the preview. Follow the job's progress, then fetch the finished preview with Get Launch Preview Result; the stored result has the same shape as the 200 response below and is kept for 2 hours, for the user who asked for it.
Gating: a product is blocked when it is not listed on the account's sales channel, is archived, has no stock, has cover below the pause threshold, or would stock out at the launch budget. Blocked rows carry a blocked_reason; eligible rows carry the planned changes, daily_budget, target_poas, default_bid and chosen keywords. already_advertised flags products already in a campaign on this account.
Requires the advertising.manage permission and the Advertising Manager feature.
Body fields:
ad_account_id(required, existing ad account ID)product_ids(required, 1-500 distinct existing product IDs)template_id(optional, launch template ID; must match the account's platform). Defaults to the platform's default template, else a built-in structure.daily_budget_per_product(optional, > 0, max 100000). Defaults to the template budget (10/day). Not needed when adding to an existing campaign withtarget_campaign_id, whose budget is kept. When the template caps by cover, the budget is reduced so the launch cannot outrun stock.launch_state(optional):paused(default) orenabled- the state campaigns are created in on approval. Walmart campaigns are always created paused.target_poas(optional, 1.0-20). Defaults to the template's break-even-minus-margin target, else 1.25.keywords(optional object keyed by product ID): arrays (max 200) of{text (required, max 255), match_type (exact|phrase|broad, optional), bid (> 0, optional)}. A product left out ofkeywordsgets the platform's top 10 recommendations; a product sent with an empty list ("2042": []) gets no keywords. Bids default to min(suggested bid, prior CPC).competitor_asins(optional object keyed by product ID): arrays (max 100) of 10-character alphanumeric ASINs for product targeting.wave_size(optional, 1-500): products per wave. Default: all eligible products in one wave.wave_interval_days(optional, 1-90, default 7): days between waves.campaign_type(optional, campaign type value such asamazon_sp,ebay_general,google_shopping). Ignored when it does not belong to the account's platform.target_campaign_id(optional, existing campaign ID in the same account): add products to this campaign instead of creating new ones: the existing Google Performance Max campaign (as an asset group) or TikTok GMV Max campaign (into its product set). A campaign on another account is ignored.final_urls(optional, max 20 HTTPS URLs; used by platforms that need a landing page).start_date(optional,Y-m-d, today or later).
Request
Responses
- 200
- 202
- 401
- 403
- 422
- 429
OK
Response Headers
Accepted
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.