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

# Add Brands To Brand List

> Add brands to an existing Microsoft Ads brand list, up to 5000 per run

Add brands to an existing Microsoft Ads brand list, up to 5000 per run. Brands are identified by numeric ID only, which microsoft\_ads\_list\_shared\_list\_items returns for an existing list.

|                       |                                          |
| --------------------- | ---------------------------------------- |
| **App**               | Microsoft Ads                            |
| **Operation ID**      | `microsoft_ads_add_brands_to_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 that owns the brand list.                                                                                                                                                                                                                            |
| `list_id`   | string or integer                                                         | Yes      | -       | ID of the brand list to add to. microsoft\_ads\_list\_shared\_lists returns these when the list type is BrandList.                                                                                                                                                                    |
| `brand_ids` | string or array of string or integer                                      | Yes      | -       | Brand IDs to add, as a list or comma separated, up to 5000 per run. Microsoft exposes no operation to look a brand up by name, so these IDs have to come from a brand list built in the Microsoft Advertising interface and read back 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 how many brands were added.

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