> ## 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** | 1 |
| **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`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.