---
title: "add_negative_keyword_lists_to_live_campaigns. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/add_negative_keyword_lists_to_live_campaigns
description: "Attach existing Google Ads negative keyword lists to campaigns that are ALREADY LAUNCHED — a live edit that syncs through to Google. Writes tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# add_negative_keyword_lists_to_live_campaigns

Attach existing Google Ads negative keyword lists to campaigns that are ALREADY LAUNCHED — a live edit that syncs through to Google.

Writes [search](https://metadata.io/developers/tools/#cat-search)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `campaignIds` | array | required | Wizard campaign ids of the LIVE (already launched) campaigns to update. Pass every campaign the user named in one call. Draft campaigns are skipped with a reason. |
| `listNames` | array |   | Names of existing negative keyword lists to attach. Matched exactly (case-insensitive) against the account library; an unmatched name is reported, never substituted. |
| `listIds` | array |   | IDs of existing negative keyword lists to attach, as returned by list_negative_keywords_list. Can be combined with listNames. |
| `mode` | string |   | 'add' (default) merges with the lists already on the campaign. 'replace' makes the campaign's negative lists exactly the ones requested, detaching the rest — only for an explicit user request.one of: `add`, `replace` |
| `channel` | string |   | Ad channel scope. Only GOOGLE_ADS is supported — the platform's live-edit endpoint is Google-only.one of: `GOOGLE_ADS` |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other search tools:

- [add_keywords_to_negative_lists](https://metadata.io/developers/tools/add_keywords_to_negative_lists) Writes
- [create_keywords](https://metadata.io/developers/tools/create_keywords) Writes
- [create_negative_keywords_list](https://metadata.io/developers/tools/create_negative_keywords_list) Writes
- [delete_negative_keyword_lists](https://metadata.io/developers/tools/delete_negative_keyword_lists) Destructive
- [duplicate_negative_keywords_list](https://metadata.io/developers/tools/duplicate_negative_keywords_list) Writes
- [experiments_keywords_stats](https://metadata.io/developers/tools/experiments_keywords_stats) Read
- [get_negative_keywords_list_details](https://metadata.io/developers/tools/get_negative_keywords_list_details) Read
- [list_experiment_keywords](https://metadata.io/developers/tools/list_experiment_keywords) Read

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)