Skip to main content

Bulk Update Ad Entities

POST 

/api/advertising/bulk

Applies one action to up to 5,000 campaigns, ad groups, items, targets or products at once.

Required scope: advertising:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Platform actions (bids, budgets, state, negatives) create one manual change set per ad account in the selection, with a line per entity, so caps, approval, drift checks and undo all apply; nothing reaches a platform until the change set is approved. Entities that cannot take the action (e.g. a campaign for a bid action, no current bid to scale, already paused) are returned in skipped with a reason instead of failing the batch. Goal and label actions are SKU.io-side writes and never reach a platform.

Body fields

  • action (required): change_bid_by_percent, set_bid, change_budget_by_percent, set_budget, pause, enable, add_negatives, change_goal, apply_label, remove_label.
  • entity_type (required): campaign, ad_group, item, target or product.
  • entity_ids (required): 1-5,000 integer IDs.
  • value: required for the four bid/budget actions. A percentage between -90 and 500 (not 0) for the _by_percent actions; otherwise an amount > 0 and ≤ 1,000,000.
  • negatives: required for add_negatives (campaigns or ad groups), up to 200 entries. Each has expression (required, ≤ 500 chars), match_type (exact, phrase, broad, asin, optional) and target_type (keyword or product, optional).
  • goal: required for change_goal: profit, growth, launch, liquidate, defend or hold. Goals are set on products (or the products behind selected items or campaigns).
  • goal_params (optional object): goal parameters, e.g. a target POAS.
  • goal_ad_account_id (optional): scope the goal to one ad account.
  • label_id: required for apply_label / remove_label. Labels attach to campaigns, ad groups, targets or products.
  • dry_run (optional, default false): preview the change sets (status simulated) without submitting.
  • reason (optional, ≤ 1000 chars).

Returns 201 with the submitted change sets, or 200 for a dry run. goals_written, labels_attached and labels_removed count SKU.io-side writes.

Requires the advertising.manage permission.

Also requires the advertising-manager feature (Advertising Manager plan); without it the endpoint returns 404.

Request​

Responses​

OK

Response Headers
    Content-Type