Skip to main content

Update Optimizer Settings

PUT 

/api/advertising/optimizer/settings

Sets the bid optimizer mode and returns the full optimizer settings (same shape as Get Optimizer Settings). The change is recorded in the activity log.

Required scope: advertising:write

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

Requires the advertising.manage permission; the tenant must have the advertising-manager feature enabled. Setting auto additionally requires the advertising.approve permission (403 otherwise) and a recent backtest that beats the bid-to-target-POAS rule on contribution; without one the request is refused with a 422 under errors.optimizer_mode explaining what to do.

Modes: off (no scheduled runs), monitor (estimates only, no change sets), suggest (each run creates a pending change set for review), auto (change sets are applied without review).

Body fields:

  • optimizer_mode (required): off, monitor, suggest or auto.

Request​

Responses​

OK

Response Headers
    Content-Type