---
title: "update_target_group. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/update_target_group
description: "Update existing target group with new name and/or targeting criteria. Destructive tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# update_target_group

Update existing target group with new name and/or targeting criteria.

Destructive [audiences](https://metadata.io/developers/tools/#cat-audiences)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `target_group_id` | integer | required | The unique ID of the target group to update. Must be a positive integer. Use list_target_groups to find the ID by name. |
| `name` | string | required | REQUIRED: Target group name. CRITICAL - This is a PUT request so you MUST provide the name even if not changing it. Use retrieve_target_group_by_id to get the current name if you don't have it. |
| `targeting` | object |   | Updated targeting configuration (optional). Structure must match create_target_group format. Only update criteria that have isModifiable=true in the current configuration. All criteria IDs/references must come from search_target_group_criteria tool. REQUIRED: Must estimate this targeting first and v |

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

## Response

## Related

Other audiences tools:

- [archive_audience](https://metadata.io/developers/tools/archive_audience) Destructive
- [create_audience_from_segment](https://metadata.io/developers/tools/create_audience_from_segment) Writes
- [create_bombora_audience](https://metadata.io/developers/tools/create_bombora_audience) Writes
- [create_csv_upload_linkedin_native_audience](https://metadata.io/developers/tools/create_csv_upload_linkedin_native_audience) Writes
- [create_facebook_native_criteria_audience](https://metadata.io/developers/tools/create_facebook_native_criteria_audience) Writes
- [create_firmographic_audience](https://metadata.io/developers/tools/create_firmographic_audience) Writes
- [create_g2_intent_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_dynamic_audience) Writes
- [create_g2_intent_linkedin_native_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_linkedin_native_dynamic_audience) Writes

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)