Skip to main content

Run Rule

POST 

/api/advertising/rules/:rule/run

Runs a rule now, outside its schedule. The run is queued and tracked: the response returns a tracked_job_log_id to poll for progress. When it finishes, read the result with List Rule Runs / Get Rule Run.

Required scope: advertising:write

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

With dry_run: true the run produces simulated change sets only (nothing is submitted for approval or applied), and the rule's last_run_at is not updated.

Requires the advertising.manage permission and the Advertising Manager feature.

Body fields:

  • dry_run (optional, boolean, default false)
  • days (optional, integer 7-90; ignored by this endpoint, used by Backtest Rule)

A real run skips an ad account (and makes no change set for it) while SKU.io automation is paused by the kill switch (automation_paused) or when the account has no write access yet (write_access_pending); dry runs and backtests are not affected.

Request​

Responses​

OK

Response Headers
    Content-Type