Update Ad Automation Settings
PUT/api/advertising/automation-settings
Updates the automation caps and/or the approval threshold, for the whole tenant (omit ad_account_id or send null) or as an override for one ad account. Caps are a partial update: the keys you send are merged into the row's existing caps, and an account override only needs the keys that differ from the tenant. The change is recorded in the activity log. Returns the same shape as Get Ad Automation Settings for the edited scope.
advertising:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Body fields (all optional):
ad_account_id(integer, nullable): the account to override; null edits the tenant row.caps(object; only the keys below are accepted):max_changes_per_set(integer 1 to 5000)max_changes_per_day(integer 1 to 100000)max_bid_change_pct(number 0 to 1000)max_bid(object keyed by platform:amazon_ads,ebay,google_ads,walmart_connect,meta_ads,tiktok_ads; each value > 0)min_bid(object keyed by platform; each value > 0 and not above that platform'smax_bidin the same request)max_budget_increase_pct_per_day(number 0 to 1000)max_daily_spend_increase(number >= 0, nullable for no limit)blast_radius_pct(number 0 to 100)metric_preference(poasoracos)
approval_policy_threshold_spend(number >= 0, nullable): estimated daily spend change above which a set goes through the tiered approval policy; null clears it.
To pause or resume automation use Set Ad Automation Kill Switch.
Requires the advertising.approve permission. Personal access tokens need the advertising:write scope.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
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 Entity
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.