> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Campaigns

> Lists campaigns in the connected OpenAI Ads (ChatGPT Ads) account

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**:

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