> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Keywords To Negative List

> Add negative keywords (Exact or Phrase match) to an existing Microsoft Ads shared negative keyword list

Add negative keywords (Exact or Phrase match) to an existing Microsoft Ads shared negative keyword list.

|                       |                                               |
| --------------------- | --------------------------------------------- |
| **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.                                                                                         |
| `list_id`  | string or SelectItem                                                      | Yes      | -       | The ID of the existing negative keyword list to add keywords to.                                                                                              |
| `keywords` | array (also accepts a comma-separated string)                             | Yes      | -       | 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.

**Fields**: `message`, `list_id`, `keywords_added_count`