Inputs
MicrosoftAdsAccountItem
Output
Type:Dict
Returns how many brands were added.
Fields: list_id, brands_added, brand_idsDocumentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Add brands to an existing Microsoft Ads brand list, up to 5000 per run
| 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) |
| 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. |
| 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. |
Dict
Returns how many brands were added.
Fields: list_id, brands_added, brand_ids