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