Create PMax Asset Group - Markifact

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