# openai_ads_get_ad_groups

> List one page of ChatGPT Ads ad groups for a campaign. One of 55 ChatGPT Ads tools on the Get MCP Ads MCP gateway.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [ChatGPT Ads](https://www.getmcpads.com/docs/sources/chatgpt-ads)

List one page of ChatGPT Ads ad groups for a campaign. Native ad group IDs are adgrp_ identifiers; preserve has_more and last_id.

> **Note** Connect with the Ads Management API key from Ads Manager Settings, then select the verified advertising account. Native account permissions and feature eligibility apply.

|  |  |
| --- | --- |
| Source | [ChatGPT Ads](https://www.getmcpads.com/docs/sources/chatgpt-ads) |
| Kind | Read |
| Discovery | Reachable through `search_tools` and `run_tool` |
| Account parameter | `adAccountId` |
| Endpoint | https://mcp.getmcpads.com/openai-ads/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `adAccountId` | string | Required | Exact verified and selected ChatGPT Ads account ID. The key is scoped to this account. |
| `campaignId` | string | Required | Exact campaign ID in the selected advertising account. |
| `limit` | integer | Optional | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `100`. |
| `after` | string | Optional | Next-page cursor: the previous page's last_id, only when has_more is true. |
| `before` | string | Optional | Opaque cursor for the previous page returned by Meta. |
| `name` | string | Optional | Human-readable name for this object. |
| `include` | array | Optional | Request native reasons why this entity cannot serve. Paused state is intentional during acceptance. |
| `order` | string | Optional | One of: `asc`, `desc`. Default: `"desc"`. |

## Calling it

Through run_tool, since it is not announced

```json
{
  "name": "run_tool",
  "arguments": {
    "name": "openai_ads_get_ad_groups",
    "args": {
      "adAccountId": "<string>",
      "campaignId": "<string>"
    }
  }
}
```

- [ChatGPT Ads metrics](https://www.getmcpads.com/docs/sources/chatgpt-ads/metrics): What you can ask for.
- [ChatGPT Ads dimensions](https://www.getmcpads.com/docs/sources/chatgpt-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/chatgpt-ads/tools/openai_ads_get_ad_groups
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.