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

# Create Brand List

> Create a brand list in a Microsoft Ads account, optionally populated with brands

Create a brand list in a Microsoft Ads account, optionally populated with brands. Brand lists drive brand inclusion and exclusion on Performance Max and AI Max campaigns. Brands are identified by numeric ID only; Microsoft offers no name lookup, so get IDs from a list built in their interface and read back with microsoft\_ads\_list\_shared\_list\_items.

|                       |                                   |
| --------------------- | --------------------------------- |
| **App**               | Microsoft Ads                     |
| **Operation ID**      | `microsoft_ads_create_brand_list` |
| **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 to create the brand list in.                                                                                                                                                                                                                                                                                                                   |
| `name`      | string                                                                    | Yes      | -       | Name for the brand list, up to 255 characters.                                                                                                                                                                                                                                                                                                                                  |
| `brand_ids` | string or array of string or integer                                      | No       | -       | Brand IDs to add on creation, as a list or comma separated. Optional; the list can be created empty and filled later with microsoft\_ads\_add\_brands\_to\_brand\_list. Microsoft exposes no way to look a brand up by name, so these IDs have to come from a brand list built in the Microsoft Advertising interface, readable with microsoft\_ads\_list\_shared\_list\_items. |

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

## Output

**Type**: `Dict`

Returns the new brand list and how many brands it was created with.

**Fields**: `list_id`, `name`, `type`, `brands_added`, `brand_ids`