Add Negative Keywords To Campaigns

Add Exact/Phrase negative keywords to Microsoft Ads campaigns or remove selected negative keyword IDs. To change a negative, explicitly remove then add. Returns per-row outcomes; do not retry successful rows.


App	Microsoft Ads
Operation ID	`microsoft_ads_add_negative_keywords_to_campaigns`
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 campaigns.
`action`	enum (`add`, `remove`)	No	`add`	Add negatives (default) or remove selected negative keyword IDs. To change text or match type, explicitly remove the old negative then add its replacement.
`negative_keyword_id`	string	No	-	Negative keyword ID returned by microsoft_ads_list_negative_keywords. Required for single remove; keyword text and match_type are not needed.
`update_type`	string or SelectableOption	Yes	-	Choose whether to add or remove a negative keyword to a single campaign or to multiple campaigns at once. Options: ‘single’ or ‘bulk’.
`campaign_id`	string or SelectItem	No	-	The campaign ID whose negative keywords to manage. Required for single add or remove.
`keyword`	string	No	-	The negative keyword text to add. Required for single add.
`match_type`	string or SelectableOption	No	-	Negative keyword match type. Options: Exact or Phrase (Microsoft negative keywords do not support Broad). Required for single add.
`structured_data`	array (also accepts a comma-separated string)	No	-	Structured data for bulk add. Required columns: ‘campaign_id’, ‘keyword’, ‘match_type’. For bulk remove use campaign_id and negative_keyword_id instead.

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.

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns created_count, failed_count and per-keyword results with campaign_id, negative_keyword_id, keyword, match_type and action (added, failed or unknown). Bulk results include the original 1-based row_number. Rejected rows include Microsoft’s error; interrupted runs preserve completed results and include an error explaining the remaining rows. Remove returns removed_count, failed_count and per-ID results (removed or failed); interrupted batches include error and preserve confirmed results. Fields: removed_count, message, created_count, failed_count, results, error

Get Started

Guides

Operations

Add Negative Keywords To Campaigns

Inputs

MicrosoftAdsAccountItem

SelectItem

SelectableOption

Output

​Inputs

​MicrosoftAdsAccountItem

​SelectItem

​SelectableOption

​Output

Inputs

MicrosoftAdsAccountItem

SelectItem

SelectableOption

Output