> ## 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                                                                                                                     |
| ------------------------ | ----------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `name_search`            | string                              | No       | -       | Filter campaigns by name (case-insensitive substring match, applied by the OpenAI Ads API).                                     |
| `status`                 | array of string or SelectableOption | No       | -       | Filter campaigns by status. Supported values: active, paused, archived. Multiple can be selected; applied client-side.          |
| `include_serving_issues` | boolean                             | No       | -       | When true, each campaign 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 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
  }
]
```