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.
advertising:writeGrant 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,targetorproduct.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_percentactions; otherwise an amount > 0 and ≤ 1,000,000.negatives: required foradd_negatives(campaigns or ad groups), up to 200 entries. Each hasexpression(required, ≤ 500 chars),match_type(exact,phrase,broad,asin, optional) andtarget_type(keywordorproduct, optional).goal: required forchange_goal:profit,growth,launch,liquidate,defendorhold. 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 forapply_label/remove_label. Labels attach to campaigns, ad groups, targets or products.dry_run(optional, default false): preview the change sets (statussimulated) 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
- 200
- 201
- 401
- 403
- 422
- 429
OK
Response Headers
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.