MMetadata /docs
Docs/Tools/remove_target_groups_from_campaign

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

ArgumentTypeNotes
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.

Other audiences tools:

All 160 tools · machine-readable index