> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apply Brand List To Campaigns

> Apply a Microsoft Ads brand list to campaigns as a brand inclusion or a brand exclusion

Apply a Microsoft Ads brand list to campaigns as a brand inclusion or a brand exclusion. An inclusion keeps a campaign on queries mentioning those brands; an exclusion stops ads serving on them, which is the usual way to keep broad match off unrelated brand terms. Inclusions can only be changed while search term matching is enabled on the campaign.

|                       |                                               |
| --------------------- | --------------------------------------------- |
| **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)                         |

## Inputs

| 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. |

### MicrosoftAdsAccountItem

| 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. |

### SelectItem

| 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. |

## Output

**Type**: `Dict`

Returns which campaigns the brand list was applied to and how.

**Fields**: `message`, `list_id`, `campaigns_count`, `associated_campaign_ids`, `is_exclusion`