List Ad Groups - Markifact

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.
`status`	array of string or SelectableOption	No	-	Filter ad groups by status. Supported values: active, paused, archived. Multiple can be selected; applied client-side.
`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
    }
  }
]