remove_target_groups_from_campaign
Remove targeting groups 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 targeting groups from one or more channels in an existing campaign.
Use this tool to detach a named Targeting Group from a channel (e.g. remove
"Tech Decision Makers" from LINKEDIN). Channel + targeting-group IDs are resolved
internally — you only need the channel type and the targeting group name. (Targeting
groups are NOT audiences — to remove a standard audience use
remove_audiences_from_campaign.)
Works on both campaign structures. On a Channel-First / Native (N×N×N) campaign the
targeting group is cleared from its WizNativeAdContainer.targetingGroupId; any
container then left with no asset at all is dropped. On Precision/METADATA it uses the
legacy group delete.
KEYWORDS: remove, delete, targeting group, target group, channel, campaign
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_target_groups: Object mapping channel type → list of targeting group names
EXAMPLE:
remove_target_groups_from_campaign({
"campaign_id": 42545,
"channel_target_groups": {"LINKEDIN": ["Tech Decision Makers"]}
})Arguments
| Argument | Type | Notes | |
|---|---|---|---|
campaign_id |
integer | required | The unique identifier of the campaign |
channel_target_groups |
object | required | Map of channel type to list of targeting group names to remove. Example: {"LINKEDIN": ["Tech Decision Makers"]} |
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_target_groups_from_campaign","arguments":{"campaign_id":0,"channel_target_groups":{}}}}'
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: