MMetadata /docs
⌘K
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

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.

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 is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.

Other campaigns tools:

Browse the tool catalog · machine-readable index