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

# Create PMax Asset Group

> Create an asset group for a Microsoft Ads Performance Max campaign

Create an asset group for a Microsoft Ads Performance Max campaign. Uploads image URLs to the Microsoft media library, links text and image assets, and calls the REST AddAssetGroups endpoint.

|                       |                                         |
| --------------------- | --------------------------------------- |
| **App**               | Microsoft Ads                           |
| **Operation ID**      | `microsoft_ads_create_pmax_asset_group` |
| **Type**              | Action                                  |
| **Connection**        | `microsoft_ads` (required)              |
| **Credits per run**   | 3                                       |
| **Agent / MCP tool**  | Yes                                     |
| **Requires approval** | Yes (write operation)                   |

## 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 contains the campaign.                                                                                                                               |
| `campaign_id`             | string or SelectItem                                                      | Yes      | -           | Select the Performance Max campaign for this asset group.                                                                                                                                  |
| `asset_group_name`        | string                                                                    | Yes      | -           | Name for the new asset group.                                                                                                                                                              |
| `status`                  | string or SelectableOption                                                | No       | `PAUSED`    | Initial asset group status. Default: PAUSED.                                                                                                                                               |
| `final_url`               | string                                                                    | Yes      | -           | Landing page URL for the asset group. Must start with http\:// or `https://.`                                                                                                              |
| `final_mobile_url`        | string                                                                    | No       | -           | Optional mobile landing page URL. If provided, final\_url is also sent.                                                                                                                    |
| `path1`                   | string                                                                    | No       | -           | Optional display URL path 1. Maximum 15 characters.                                                                                                                                        |
| `path2`                   | string                                                                    | No       | -           | Optional display URL path 2. Maximum 15 characters.                                                                                                                                        |
| `final_url_suffix`        | string                                                                    | No       | -           | Optional final URL suffix with tracking parameters.                                                                                                                                        |
| `tracking_url_template`   | string                                                                    | No       | -           | Optional tracking URL template.                                                                                                                                                            |
| `headlines`               | array of string                                                           | Yes      | -           | Headlines for the asset group. Provide 3-15 items, each max 30 characters.                                                                                                                 |
| `long_headlines`          | array of string                                                           | Yes      | -           | Long headlines for the asset group. Provide 1-5 items, each max 90 characters.                                                                                                             |
| `descriptions`            | array of string                                                           | Yes      | -           | Descriptions for the asset group. Provide 2-5 items, each max 90 characters.                                                                                                               |
| `business_name`           | string                                                                    | Yes      | -           | Business name for the asset group. Maximum 25 characters.                                                                                                                                  |
| `marketing_images`        | array of string                                                           | Yes      | -           | Landscape images for Microsoft AssetGroup Images. Accepts direct image URLs or Google Drive share links (set to 'Anyone with the link'). Provide 1-20 images, 1.91:1, at least 703x368 px. |
| `square_marketing_images` | array of string                                                           | Yes      | -           | Square images for Microsoft AssetGroup Images. Accepts direct image URLs or Google Drive share links (set to 'Anyone with the link'). Provide 1-20 images, 1:1, at least 128x128 px.       |
| `logo_images`             | array of string                                                           | No       | -           | Optional square logo images. Accepts direct image URLs or Google Drive share links (set to 'Anyone with the link'). Up to 5 logos, 1:1, at least 128x128 px.                               |
| `landscape_logo_images`   | array of string                                                           | No       | -           | Optional landscape logo images. Accepts direct image URLs or Google Drive share links (set to 'Anyone with the link'). Up to 5 logos, 4:1, at least 512x128 px.                            |
| `call_to_action`          | string or SelectableOption                                                | No       | `LearnMore` | Optional call to action. Default: LearnMore.                                                                                                                                               |
| `search_themes`           | string or array of string                                                 | No       | -           | Optional Performance Max search themes. Pass comma/newline-separated text or a list.                                                                                                       |

### 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**: `Dict`

Returns the created Microsoft Ads asset group and uploaded media IDs.

**Fields**: `asset_group_id`, `asset_group_name`, `campaign_id`, `status`, `final_url`, `uploaded_images_count`, `uploaded_media`