Inputs
MicrosoftAdsAccountItem
SelectItem
Output
Type:Dict
Returns which campaigns the brand list was applied to and how.
Fields: message, list_id, campaigns_count, associated_campaign_ids, is_exclusionDocumentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Apply a Microsoft Ads brand list to campaigns as a brand inclusion or a brand exclusion
| App | Microsoft Ads |
| Operation ID | microsoft_ads_apply_brand_list_to_campaigns |
| Type | Action |
| Connection | microsoft_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Requires approval | Yes (write operation) |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
account | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Select the Microsoft Ads account that owns the brand list and campaigns. |
list_id | string or SelectItem | Yes | - | ID of the brand list to apply. microsoft_ads_list_shared_lists returns these when the list type is BrandList. |
campaign_ids | array (also accepts a comma-separated string) | Yes | - | Campaign IDs to apply the brand list to. Comma separated text or a list of IDs. |
is_exclusion | boolean | Yes | - | False applies the list as a brand INCLUSION, so the campaign only chases queries mentioning those brands. True applies it as a brand EXCLUSION, so ads stop serving on queries mentioning them. Microsoft requires this choice; there is no default. Inclusions can only be added or removed while search term matching is enabled on the campaign, and Microsoft rejects the request otherwise. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - | |
customerId | string | No | - | The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | The value of the selectable item. |
label | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |
Dict
Returns which campaigns the brand list was applied to and how.
Fields: message, list_id, campaigns_count, associated_campaign_ids, is_exclusion