Set Ad Automation Kill Switch
POST/api/advertising/automation-settings/kill-switch
Turns the automation kill switch on or off, tenant-wide (omit ad_account_id) or for one ad account. While the kill switch is on, new change sets always wait for a person, and approving or retrying a change set is refused until it is turned off. The tenant-wide switch overrides every account. The change is recorded in the activity log. Returns the same shape as Get Ad Automation Settings for the affected scope.
advertising:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Body fields:
on(required, boolean): true pauses automation, false resumes it.ad_account_id(optional, integer, nullable): the account to pause; null or absent means tenant-wide.
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.