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