reddit_ads_list_ad_groups
List Reddit Ad Groups
RedditDescription
List Reddit ad groups for an ad account. Shows targeting, bid strategy and bid, the spend goal (Reddit's budget lives here), configured and delivery status, and campaign association.
Read-onlyIdempotentOpen-world
Usage
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "reddit_ads_list_ad_groups",
"arguments": {}
}
}
hopkin reddit ad-groups list
| Flag | Type | Required | Description |
|---|---|---|---|
--account | string | Required | Reddit ad account ID. |
--ad-group-id | string | Optional | Fetch a single ad group by ID. |
--ad-group-ids | array | Optional | Fetch specific ad groups by IDs. |
--campaign | string | Optional | Filter by parent campaign ID. |
--status | array | Optional | Filter by status. |
--limit | integer | Optional | |
--cursor | string | Optional | Opaque pagination cursor. |
--refresh | boolean | Optional | |
--connection-id | string | Optional | Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs. |
{
"mcpServers": {
"reddit-ads": {
"url": "https://reddit.mcp.hopkin.ai",
"transport": "sse"
}
}
}
No example prompts available.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
string |
Required | Reddit ad account ID.minLength: 1, maxLength: 64 |
reason |
string |
Required | Why this tool call is neededminLength: 1, maxLength: 500 |
Optional parameters (8)
| Name | Type | Required | Description |
|---|---|---|---|
ad_group_id |
string |
Optional | Fetch a single ad group by ID.maxLength: 64 |
ad_group_ids |
array |
Optional | Fetch specific ad groups by IDs. |
campaign_id |
string |
Optional | Filter by parent campaign ID.maxLength: 64 |
status |
array |
Optional | Filter by status. |
limit |
integer |
Optional | min: 1, max: 100 |
cursor |
string |
Optional | Opaque pagination cursor. |
refresh |
boolean |
Optional | |
connection_id |
string |
Optional | Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs. |