Add Negative Keywords To Ad Groups - Markifact

Add Exact/Phrase negative keywords to Microsoft Ads ad groups or remove selected negative keyword IDs. To change a negative, explicitly remove then add.


App	Microsoft Ads
Operation ID	`microsoft_ads_add_negative_keywords_to_ad_groups`
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 ad groups.
`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 ad group or to multiple ad groups at once. Options: ‘single’ or ‘bulk’.
`ad_group_id`	string or SelectItem	No	-	The ad group 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: ‘ad_group_id’, ‘keyword’, ‘match_type’. For bulk remove use ad_group_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 Microsoft Ads added negative keyword results. Remove returns removed_count, failed_count and per-ID results (removed or failed); interrupted batches include error and preserve confirmed results. Fields: removed_count, failed_count, error, message, created_count, results