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

> List asset groups within a Microsoft Ads Performance Max campaign, optionally filtered by status and editorial (approval) status

List asset groups within a Microsoft Ads Performance Max campaign, optionally filtered by status and editorial (approval) status. Returns the full Microsoft asset group objects (Id, Name, Status, EditorialStatus, FinalUrls, Headlines, Descriptions, Images, etc.) so they can be fed into update\_asset\_group.

|                      |                                   |
| -------------------- | --------------------------------- |
| **App**              | Microsoft Ads                     |
| **Operation ID**     | `microsoft_ads_list_asset_groups` |
| **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 that owns the campaign.                                                                                                                                                   |
| `campaign_id`              | string or SelectItem                                                      | Yes      | -       | The Performance Max campaign to list asset groups for.                                                                                                                                                     |
| `statuses`                 | array of string or SelectableOption                                       | No       | -       | Filter by asset group status. Leave empty to return all statuses. Available values: Active, Paused, Expired. Deleted asset groups are never returned by Microsoft Ads.                                     |
| `editorial_statuses`       | array of string or SelectableOption                                       | No       | -       | Filter by asset group editorial (approval) status. Leave empty to return all. Available values: Active (approved), ActiveLimited, Disapproved, Inactive (under review).                                    |
| `return_additional_fields` | boolean                                                                   | No       | `False` | When true, request additional asset group properties (search themes, URL targets, tracking template, final URL suffix, URL custom parameters, cropping type) 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. |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

### SelectableOption

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

## Output

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

Returns the matching asset groups as full Microsoft Ads asset group objects (unchanged from the API).

**Fields**: `Id`, `Name`, `Status`, `EditorialStatus`, `FinalUrls`