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 IDArguments
| Argument | Type | Notes | |
|---|---|---|---|
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.
Related
Other audiences tools: