MMetadata /docs
Docs/Tools/remove_channels_from_campaign

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 channel

Arguments

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

Other campaigns tools:

All 160 tools · machine-readable index