> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Ad Groups

> Lists Reddit Ads ad groups with full details, optionally filtered by campaign

Lists Reddit Ads ad groups with full details, optionally filtered by campaign. Money values are returned in raw microcurrency (divide by 1,000,000 for the account currency).

|                      |                             |
| -------------------- | --------------------------- |
| **App**              | Reddit Ads                  |
| **Operation ID**     | `reddit_ads_list_ad_groups` |
| **Type**             | Action                      |
| **Connection**       | `reddit_ads` (required)     |
| **Credits per run**  | 1                           |
| **Agent / MCP tool** | Yes                         |

## Inputs

| Field          | Type                 | Required | Default | Description                                                                         |
| -------------- | -------------------- | -------- | ------- | ----------------------------------------------------------------------------------- |
| `account`      | DynamicAccount       | Yes      | -       | Select the Reddit Ads account to list ad groups for.                                |
| `campaign_id`  | string or SelectItem | No       | -       | Optionally filter to ad groups of a single campaign ID.                             |
| `search_query` | string               | No       | -       | Optional text filter applied to ad groups names (case-insensitive substring match). |
| `limit`        | integer              | No       | `100`   | Maximum number of ad groups to return. Default: 100.                                |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

## Output

**Type**: `List[Dict]`

Returns the list of ad groups.

**Fields**: dynamic (depend on the inputs)