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.
advertising:writeGrant 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 includesstructure_tracked_job_log_idandperformance_tracked_job_log_idfor 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):monitorraises signals only,suggestalso proposes change sets for approval,autoapplies them without approval.suggestandautoare rejected (422) while the platform has read-only access. Switching an account toautofrom any other mode also needs theadvertising.approvepermission (otherwise403); resendingautofor an account already inauto, or moving it out ofauto, 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
- 200
- 401
- 403
- 404
- 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
Response Headers
Not Found
Response Headers
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.