Create Brand List

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

Get Started

Guides

Operations

Inputs

MicrosoftAdsAccountItem

Output

​Inputs

​MicrosoftAdsAccountItem

​Output

Inputs

MicrosoftAdsAccountItem

Output