Skip to main content

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.

Required scope: advertising:write

Grant 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​

OK

Response Headers
    Content-Type