List Ads

Lists ads in the connected OpenAI Ads account

Lists ads in the connected OpenAI Ads account. Pass an ad_group_id to scope to one ad group, or a campaign_id to scope to a campaign’s ad groups, or omit both to list ads across the whole account. Returns raw ad 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_ads
Type	Action
Connection	openai_ads (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
ad_group_id	string or SelectableOption	No	-	Ad group ID to list ads for. Optional — if omitted, ads across all ad groups (optionally scoped by campaign_id) are returned.
campaign_id	string or SelectableOption	No	-	Campaign ID to scope ads to. Optional and ignored when ad_group_id is set. If only campaign_id is given, ads across that campaign’s ad groups are returned; if neither is given, ads across the whole account.
name_search	string	No	-	Filter ads by name (case-insensitive substring match, applied client-side).
status	array of string or SelectableOption	No	-	Filter ads by status. Supported values: active, paused, archived. Multiple can be selected; applied client-side.
include_serving_issues	boolean	No	-	When true, each ad 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 ads 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 objects exactly as returned by the OpenAI Ads API (id, name, status, creative, review, review_status, created_at, updated_at), plus injected ad_group_id and campaign_id identifying the parent ad group and campaign.

Fields: dynamic (depend on the inputs)

Example:

[
  {
    "id": "ad_...",
    "ad_group_id": "adgrp_...",
    "campaign_id": "cmpn_...",
    "name": "Test Ad",
    "status": "active",
    "creative": {
      "type": "chat_card",
      "title": "Markifact",
      "target_url": "https://www.markifact.com/"
    }
  }
]