List Ad Groups

Lists ad groups in the connected OpenAI Ads account

Lists ad groups in the connected OpenAI Ads account. Pass a campaign_id to scope to one campaign, or omit it to list ad groups across all campaigns. Returns raw ad group objects exactly as returned by the API. Optionally filter by status, sort by creation order, and limit results.

App	OpenAI Ads
Operation ID	openai_ads_list_ad_groups
Type	Action
Connection	openai_ads (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
campaign_id	string or SelectableOption	No	-	Campaign ID to list ad groups for. Optional — if omitted, ad groups across all campaigns in the account are returned.
name_search	string	No	-	Filter ad groups by name (case-insensitive substring match, applied client-side).
status	array of string or SelectableOption	No	-	Filter ad groups by status. Supported values: active, paused, archived. Multiple can be selected; applied client-side.
include_serving_issues	boolean	No	-	When true, each ad group includes a serving_issues array explaining why it may not be delivering (e.g. campaign_not_active).
order	string or SelectableOption	No	-	Sort direction by creation order: ‘asc’ (oldest first) or ‘desc’ (newest first).
limit	integer	No	100	Maximum number of ad groups to return (1-1000).

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: List[Dict]

Returns a list of ad group objects exactly as returned by the OpenAI Ads API (id, name, status, bidding_config, description, product_set, created_at, updated_at), plus an injected campaign_id identifying the parent campaign.

Fields: dynamic (depend on the inputs)

Example:

[
  {
    "id": "adgrp_...",
    "campaign_id": "cmpn_...",
    "name": "Test Ad group",
    "status": "active",
    "bidding_config": {
      "billing_event_type": "click",
      "max_bid_micros": 3500000
    }
  }
]