Create Negative Keyword List

Create a shared negative keyword list in a Microsoft Ads account, optionally seeded with keywords

Create a shared negative keyword list in a Microsoft Ads account, optionally seeded with keywords.

App	Microsoft Ads
Operation ID	microsoft_ads_create_negative_keyword_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 negative keyword list in.
list_name	string	Yes	-	Name for the new negative keyword list (must be unique within the account).
keywords	array (also accepts a comma-separated string)	No	-	Optional negative keywords to seed the list with, as structured data: a list of objects each with ‘keyword’ (the text) and ‘match_type’ (‘Exact’ or ‘Phrase’). Up to 5,000 per call.

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 created Microsoft Ads negative keyword list ID and seeded keyword count.

Fields: message, list_id, list_name, keywords_added_count