---
title: "set_search_channel_locations. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/set_search_channel_locations
description: "Set the geographic targeting of a wizard campaign's search channel (Google Ads or Microsoft Ads) — which countries/states the campaign serves in, and which countries to exclude. Destructive tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# set_search_channel_locations

Set the geographic targeting of a wizard campaign's search channel (Google Ads or Microsoft Ads) — which countries/states the campaign serves in, and which countries to exclude.

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

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `campaign_id` | integer | required | The unique identifier of the wizard campaign. |
| `channel` | string | required | Which search channel on the campaign to update. Geo targeting is set per channel and only these two carry it.one of: `GOOGLE_ADS`, `MICROSOFT_ADS` |
| `countries` | array |   | Country NAMES to target, e.g. ["United States", "Canada"]. REPLACES the channel's current countries. Pass [] to clear (targets all locations). Omit to leave unchanged. |
| `states` | array |   | US state NAMES to target, e.g. ["Texas", "California"]. REPLACES the channel's current states. Pass [] to clear. Omit to leave unchanged. US states only. |
| `excluded_countries` | array |   | Country NAMES the campaign must NOT serve in, e.g. ["India"]. REPLACES the channel's current exclusions. Pass [] to clear them all. Omit to leave unchanged. Country-level only — states cannot be excluded. |

## 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
- [add_negative_keyword_lists_to_live_campaigns](https://metadata.io/developers/tools/add_negative_keyword_lists_to_live_campaigns) 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

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