Create Launch
POST/api/advertising/launch
Creates a launch and submits its first wave. The first wave's campaigns are submitted as a pending change set (source launch) that must be approved before anything is created on the platform; later waves are submitted automatically on their due dates and each is re-gated at that time. Launched products on the default Profit goal switch to the Launch goal only once their wave's change set applies: a pending, rejected, expired or failed wave never changes a product's goal.
advertising:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Each wave in waves carries wave, product_ids, due_on, status (pending, submitted, cancelled), blocked (products gated out when the wave came due), submitted_at, change_set_id (the first change set of the wave), change_set_ids (every change set of the wave: a wave larger than the account's max_changes_per_set cap is split into several) and launching_product_ids (the products the wave proposed campaigns for).
Only eligible products (see Preview Launch) are stored on the launch. If no product is eligible, nothing is created and a 422 lists the reasons under product_ids.
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).
Returns 201 with the launch.
Request
Responses
- 201
- 401
- 403
- 422
- 429
Created
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.