Labels & Portfolios
List Ad Labels
Lists SKU.io advertising labels ordered by name, each with `usage_count` (how many campaigns, ad groups, targets and products carry it). Labels are SKU.io-only tags used to group entities for filters, rules, goals, budget plans and reports; they are never sent to an ad platform.
Create Ad Label
Creates an advertising label.
Get Ad Label
Returns one label with its total `usage_count` and a `usage` breakdown by entity type (`campaign`, `ad_group`, `target`, `product`). Returns 404 for an unknown label.
Update Ad Label
Renames or recolours a label. Send only the fields to change.
Delete Ad Label
Deletes a label and removes it from every entity it was attached to. Returns 204 with no body. The deletion is logged.
Attach Ad Label
Attaches a label to campaigns, ad groups, targets or products. Already-labelled entities are left as they are; `attached` counts the new links.
Detach Ad Label
Removes a label from campaigns, ad groups, targets or products; `removed` counts the links deleted.
Get Ad Label Scope
Resolves what a label covers when used as a scope for rules, goals, budget plans or reports: the directly labelled `campaign_ids`, `ad_group_ids`, `target_ids` and `product_ids`, plus `effective_campaign_ids` (campaigns labelled directly or containing a labelled ad group, target or advertised product) and `effective_item_ids` (advertised items in scope).
List Ad Portfolios
Lists Amazon Ads portfolios with their budget caps and campaign counts. Portfolios are mirrored from Amazon on every structure sync (name, state, budget cap and its policy); a portfolio seen only on campaigns that has not been synced yet is still listed, with a placeholder name (`Portfolio <id>`), null budget fields, `editable: false` and `gap` explaining why. Not paginated.
Update Ad Portfolio Budget
Sets a new budget cap on an Amazon Ads portfolio by submitting a manual change set with one `set_budget` line. Nothing reaches Amazon until the change set is approved (Approve Change Set); it then goes through the account's automation caps and the drift check (a cap changed on Amazon since the proposal is skipped, never overwritten) and can be undone.