List Campaigns - Markifact

Lists campaigns in the connected OpenAI Ads (ChatGPT Ads) account. Optionally filter by status (active, paused, archived), sort by creation order, and limit results.


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

Inputs

Field	Type	Required	Default	Description
`status`	array of string or SelectableOption	No	-	Filter campaigns 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 campaigns to return (1-1000).

SelectableOption

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

Output

Type: List[Dict] Returns a list of campaign objects exactly as returned by the OpenAI Ads API, including id, name, status, bidding_type, budget, targeting, start_time, end_time, created_at, and updated_at. Fields: dynamic (depend on the inputs) Example:

[
  {
    "id": "cmpn_...",
    "name": "Test Campaign",
    "status": "active",
    "bidding_type": "clicks",
    "budget": {
      "daily_spend_limit_micros": 25000000
    },
    "start_time": 1781504598
  }
]