Remove Audiences from Campaign
remove_audiences_from_campaignDestructive
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, and on a
draft the audience's group is deleted from the channel, so the campaign no longer
lists it. A container left holding ads with nothing to target them is named in the
removal message.
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 audiences from one or more channels (targeting groups:
remove_target_groups_from_campaign)
- 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 IDInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| campaign_id | Yes | The unique identifier of the campaign | |
| channel_audiences | Yes | Map of channel type to list of audience names to remove. Example: {"FACEBOOK": ["Audience A"], "LINKEDIN": ["Audience B"]} |