List Ad Extension Associations

List Microsoft Ads ad extension associations for an account, campaigns, or ad groups

List Microsoft Ads ad extension associations for an account, campaigns, or ad groups. Returns the raw Microsoft Ads ad extension association objects, including each associated AdExtension when returned by the API.

App	Microsoft Ads
Operation ID	microsoft_ads_list_ad_extension_associations
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 to list ad extension associations for.
level	string or SelectableOption	Yes	-	Choose where to list ad extension associations. Available options: ‘ACCOUNT’, ‘CAMPAIGN’, ‘AD_GROUP’
ad_extension_types	array of string or SelectableOption	No	-	Filter by Microsoft Ads ad extension type. Leave empty to return all valid ad extension types for the selected association level.
campaign_ids	array of string or SelectItem	No	-	Select one or more campaigns to list ad extension associations for (required if level is CAMPAIGN)
ad_group_ids	array of string or SelectItem	No	-	Select one or more ad groups to list ad extension associations for (required if level is AD_GROUP)
return_additional_fields	boolean	No	False	When true, request additional ad extension properties such as images, display text, layouts, and source type.

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 raw Microsoft Ads AdExtensionAssociation objects.

Fields: dynamic (depend on the inputs)