> ## 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.

# 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`