Skip to main content

Update Ad Account

PUT 

/api/advertising/accounts/:adAccount

Selects or deselects an ad account, maps it to a sales channel, and sets its automation mode and cost options. Every field is optional; only the fields sent are changed.

Required scope: advertising:write

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

Requires the advertising.manage permission. Token scope: advertising:write (personal access and OAuth tokens).

Body:

  • is_selected (boolean): whether SKU.io imports and manages this account. Selecting a previously unselected account queues its first structure sync and a deep performance backfill; the response then includes structure_tracked_job_log_id and performance_tracked_job_log_id for following their progress (null when that sync is turned off for the connection).
  • sales_channel_id (integer or null): the sales channel whose orders and stock this account's ads draw on. Must exist.
  • automation_mode (off, monitor, suggest, auto): monitor raises signals only, suggest also proposes change sets for approval, auto applies them without approval. suggest and auto are rejected (422) while the platform has read-only access. Switching an account to auto from any other mode also needs the advertising.approve permission (otherwise 403); resending auto for an account already in auto, or moving it out of auto, does not.
  • name_override (string or null, max 255): display name used instead of the platform's account name.
  • cost_entry_creation_enabled (boolean): book this account's daily spend as cost entries.
  • unmapped_spend_to_channel (boolean): allocate spend on items with no matching product to the sales channel.

Returns the updated account, plus structure_tracked_job_log_id, performance_tracked_job_log_id and skipped_reason.

Request​

Responses​

OK

Response Headers
    Content-Type