MMetadata /docs
Docs/Tools/remove_audiences_from_campaign

remove_audiences_from_campaign

Remove specific audiences from one or more channels in an existing campaign.

Destructive audiences

Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.

What it does

Remove specific audiences from one or more channels in an existing campaign.

                Use this tool when you need to detach a named audience/group from a particular
                channel (e.g. remove "European Digital Nomad Investors" from FACEBOOK).
                Channel and audience IDs are resolved internally — you only need the human-readable
                channel type and audience name.

                Works on both campaign structures. On a Channel-First / Native (N×N×N) campaign the
                audience is cleared from its WizNativeAdContainer(s); any container then left with no
                asset at all (no audience, target group, keyword, ad or offer) is dropped.

                KEYWORDS: remove, delete, audience, group, channel, campaign, targeting

                WHEN TO USE:
                - User wants to remove a specific audience from a channel
                - User wants to clean up targeting groups from one or more channels
                - Multiple audiences across multiple channels can be removed in a single call

                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)
                - channel_audiences: Object mapping channel type → list of audience names to remove

                CHANNEL TYPES: FACEBOOK, INSTAGRAM, GOOGLE_ADS, LINKEDIN, MICROSOFT_ADS, REDDIT, TWITTER

                EXAMPLES:

                Remove one audience from FACEBOOK:
                remove_audiences_from_campaign({
                    "campaign_id": 42545,
                    "channel_audiences": {
                        "FACEBOOK": ["European Digital Nomad Investors_p2w8"]
                    }
                })

                Remove audiences from multiple channels at once:
                remove_audiences_from_campaign({
                    "campaign_id": 42545,
                    "channel_audiences": {
                        "FACEBOOK": ["Audience A", "Audience B"],
                        "LINKEDIN": ["Audience C"]
                    }
                })

                INTEGRATION WITH OTHER TOOLS:
                - Use get_campaign_by_wizard_id to inspect current audiences per channel before removing
                - Use search_campaigns_by_names to find the campaign ID

Arguments

ArgumentTypeNotes
campaign_id integer required The unique identifier of the campaign
channel_audiences object required Map of channel type to list of audience names to remove. Example: {"FACEBOOK": ["Audience A"], "LINKEDIN": ["Audience B"]}

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_audiences_from_campaign","arguments":{"campaign_id":0,"channel_audiences":{}}}}'

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 audiences tools:

All 160 tools · machine-readable index