Skip to main content

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.

Required scope: advertising:write

Grant 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's max_bid in 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 (poas or acos)
  • 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​

OK

Response Headers
    Content-Type