Add Keywords To Negative List - Markifact

Add Exact/Phrase negatives to a Microsoft Ads shared negative keyword list or remove selected item IDs. Removing a list item affects all campaigns using that list; other items are preserved.


App	Microsoft Ads
Operation ID	`microsoft_ads_add_keywords_to_negative_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 that owns the negative keyword list.
`action`	enum (`add`, `remove`)	No	`add`	Add negatives (default) or remove specific keywords from the shared list by ID. Removing an item affects every campaign using this list.
`negative_keyword_ids`	array of string	No	-	IDs from microsoft_ads_list_shared_list_items to remove; accepts a list, JSON array, or comma-separated IDs. Required for remove. Other list items are preserved.
`list_id`	string or SelectItem	Yes	-	The ID of the existing negative keyword list to manage.
`keywords`	array (also accepts a comma-separated string)	No	-	Negative keywords to add, 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.

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.

Output

Type: Dict Returns the negative keyword list ID and the count of keywords added. 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, results, error, message, list_id, keywords_added_count