Skip to main content

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.

Required scope: advertising:write

Grant 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 with target_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) or enabled - 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 of keywords gets 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 as amazon_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​

Created

Response Headers
    Content-Type