remove_channels_from_campaign
Disable one or more entire channels from an existing campaign.
Destructive campaigns
Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.
What it does
Disable one or more entire channels from an existing campaign.
Use this tool when the goal is to turn off a whole channel (e.g. stop running
ads on FACEBOOK entirely). To remove a specific audience from a channel instead,
use remove_audiences_from_campaign.
KEYWORDS: remove, delete, disable, channel, campaign
WHEN TO USE:
- Disable/remove an entire channel from a campaign (e.g. remove FACEBOOK or GOOGLE_ADS)
- Multiple channels can be disabled in a single call
- Returns the campaign state before and after the change
RESPONSE:
- Returns the refreshed campaign state plus a removal_results list with one
entry per requested removal recording its success or error. ALWAYS check
removal_results — a partial failure (e.g. one of two names not found) still
returns normally, so report only what actually came back successful.
REQUIRED PARAMETERS:
- campaign_id: Campaign ID (numeric identifier)
- channels: Array of channel types to disable
CHANNEL TYPES: FACEBOOK, INSTAGRAM, GOOGLE_ADS, LINKEDIN, MICROSOFT_ADS, REDDIT
EXAMPLES:
Disable a single channel:
remove_channels_from_campaign({
"campaign_id": 12345,
"channels": ["FACEBOOK"]
})
Disable multiple channels at once:
remove_channels_from_campaign({
"campaign_id": 12345,
"channels": ["FACEBOOK", "GOOGLE_ADS", "INSTAGRAM"]
})
INTEGRATION WITH OTHER TOOLS:
- Use search_campaigns_by_names to find the campaign ID
- Use get_campaign_by_wizard_id to inspect active channels before removal
- Use remove_audiences_from_campaign to remove a specific audience from a channelArguments
| Argument | Type | Notes | |
|---|---|---|---|
campaign_id |
integer | required | The unique identifier of the campaign |
channels |
array | required | List of channels to disable from the campaign. Example: ["FACEBOOK", "GOOGLE_ADS"] |
Request
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"remove_channels_from_campaign","arguments":{"campaign_id":0,"channels":[]}}}'
Response
No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs.
The request above is still the exact shape to send. Nothing on this page is invented.
Related
Other campaigns tools: