> ## 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

> List campaigns in a Microsoft Ads account, optionally filtered by campaign type and status

List campaigns in a Microsoft Ads account, optionally filtered by campaign type and status. Returns the full Microsoft campaign objects (Id, Name, Status, CampaignType, BudgetType, DailyBudget, BiddingScheme, Settings, etc.) so they can be fed into update\_campaign.

|                      |                                |
| -------------------- | ------------------------------ |
| **App**              | Microsoft Ads                  |
| **Operation ID**     | `microsoft_ads_list_campaigns` |
| **Type**             | Action                         |
| **Connection**       | `microsoft_ads` (required)     |
| **Credits per run**  | 1                              |
| **Agent / MCP tool** | Yes                            |

## Inputs

| Field                      | Type                                                                      | Required | Default | Description                                                                                                                                                                                             |
| -------------------------- | ------------------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`                  | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes      | -       | Select the Microsoft Ads account to list campaigns for.                                                                                                                                                 |
| `campaign_types`           | array of string or SelectableOption                                       | No       | -       | Filter by campaign type. Leave empty to return all types. Available values: Search, Shopping, DynamicSearchAds, Audience, Hotel, PerformanceMax, App.                                                   |
| `statuses`                 | array of string or SelectableOption                                       | No       | -       | Filter by campaign status. Leave empty to return all statuses. Available values: Active, Paused, BudgetPaused, BudgetAndManualPaused, Suspended. Deleted campaigns are never returned by Microsoft Ads. |
| `return_additional_fields` | boolean                                                                   | No       | `False` | When true, request additional campaign properties (bidding schemes, settings, budget fields, etc.) so the response is richer. Defaults to false.                                                        |

### MicrosoftAdsAccountItem

| Field        | Type   | Required | Default | Description                                                                                                     |
| ------------ | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------- |
| `value`      | string | Yes      | -       |                                                                                                                 |
| `label`      | string | Yes      | -       |                                                                                                                 |
| `customerId` | string | No       | -       | The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID. |

### SelectableOption

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

## Output

**Type**: `List[Dict]`

Returns the matching campaigns as full Microsoft Ads campaign objects (unchanged from the API).

**Fields**: `Id`, `Name`, `Status`, `CampaignType`, `BudgetType`, `DailyBudget`, `BiddingScheme`, `Settings`