Skip to main content

Get Ad Automation Settings

GET 

/api/advertising/automation-settings

Returns the automation caps, approval threshold and kill-switch state that govern every ad change set. Pass ad_account_id to also get that account's override row and its effective (merged) settings.

Required scope: advertising:read

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

Response shape: tenant is the tenant-wide settings row (its caps always fully populated with defaults). account is the requested account's override row (its caps hold only the keys it overrides) or null. effective is the merged result for that account (tenant caps overlaid with the account's overrides) or null when no account was given. kill_switch_on says whether automation is paused for the requested scope (tenant-wide, or tenant-wide OR this account); tenant_kill_switch_on is the tenant-wide switch alone; kill_switch_account_ids lists every account with its own kill switch on.

Caps: max_changes_per_set (sets larger than this are split), max_changes_per_day, max_bid_change_pct, max_bid / min_bid (absolute bids keyed by platform), max_budget_increase_pct_per_day, max_daily_spend_increase (null = no limit), blast_radius_pct (share of spend one set may touch) and metric_preference (poas or acos). A set that breaches a cap never applies without a person approving it.

Requires the advertising.view permission. Personal access tokens need the advertising:read scope.

Request​

Responses​

OK

Response Headers
    Content-Type