create_reddit_target_group
Create a new Reddit target group with name and targeting criteria (communities, interests, keywords, location).
Writes audiences
Creates or changes something in the account. Put it behind whatever review your agent uses.
What it does
Create a new Reddit target group with name and targeting criteria (communities, interests, keywords, location).
PREREQUISITE: All references MUST come from search_reddit_criteria. estimate_target_group with channel="REDDIT" first is MANDATORY: verify isMatchCountTooSmall=false and report the reach to the user BEFORE creating. Same bar as create_target_group and update_target_group (PRD-31759). Reddit estimation went live with PRD-31996; before it there was no way to size one of these, which is why a Reddit target group could be created at zero reach with nothing noticing.
USE FOR: "create a Reddit target group named X targeting r/technology", "save this Reddit audience as X".
⚠️ CHANNEL: Only use this tool when the user explicitly asked for a REDDIT target group. Do NOT infer REDDIT from the underlying audience NAMES (e.g. an audience called "Reddit Conquest Mktg LI_n7q" does NOT mean the user wants a REDDIT target group — audience naming is human convention, not a routing signal). Default to `create_target_group` (LINKEDIN) when channel is unspecified; ask the user if unsure.
TARGETING STRUCTURE (LOCATION must be the FIRST include block with isModifiable=false):
{
"include": [
{
"isModifiable": false,
"criteria": [{"type": "LOCATION", "data": {
"countries": [229],
"states": []
}}],
"audiences": []
},
{
"isModifiable": true,
"criteria": [{"type": "COMMUNITIES", "data": [
{"externalId": "t5_2qh1i", "name": "r/technology"}
]}],
"audiences": []
}
],
"exclude": {
"isModifiable": true,
"criteria": [{"type": "KEYWORDS", "data": [{"externalId": "kw_123", "name": "crypto"}]}],
"audiences": []
}
}
REDDIT CRITERIA TYPES (all references from search_reddit_criteria):
- LOCATION: {"countries": [<id>, ...], "states": [<id>, ...]} — arrays of NUMERIC Metadata IDs (use the numeric `id` from search_reddit_criteria locations, NOT the {id, name} object). MANDATORY FIRST in include, isModifiable=false
- COMMUNITIES: Array of {externalId, name} — subreddits (e.g. r/technology)
- INTERESTS: Array of {externalId, name} — Reddit interest categories
- KEYWORDS: Array of {externalId, name} — contextual keywords
INCLUDE: Array of rule blocks (AND-joined). EXCLUDE: single object with `criteria` and `audiences`.
AUDIENCES (combine with the criteria above to build complex target groups): each include
block and the exclude object also accept an `audiences` array, so you can mix existing
Metadata audiences with the Reddit criteria in the same block. Get them from the audience
listing tools / get_matched_audiences. Each audience entry: {mdAudienceId, name, type,
matchCount, matchCountType: "FIXED_SIZE", inactive, criteria: [the audience's own criteria]}.
`mdAudienceId` MUST be the numeric Custom Audience ID (integer, e.g. 49067), NEVER the
audience name string; the platform's `mdAudienceId` is typed `Long` and the tool rejects
non-integer values pre-flight. In the exclude block, use the EXCLUDE variant of the type
(e.g. RETARGETING_EXCLUDE).
RESPONSE: {id, name, channel, audienceSize, status, createdDate, targeting}
WORKFLOW: search_reddit_criteria → build targeting (LOCATION first) → confirm → create_reddit_target_groupArguments
| Argument | Type | Notes | |
|---|---|---|---|
name |
string | required | The name for the new Reddit target group. Must be unique, descriptive, and UNDER 50 characters — the platform rejects 50+ character names with a 400. |
targeting |
object | required | Complete Reddit targeting configuration with include/exclude rules. LOCATION must be the first include block. All references must come from search_reddit_criteria. |
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":"create_reddit_target_group","arguments":{"name":"<name>","targeting":{}}}}'
Response
No recorded response. This tool writes to the account, 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: