Apply Ad Extension To Entities

Attach EXISTING Microsoft Ads ad extensions to campaigns, ad groups or the whole account. The create operations attach an extension as part of building it, so this is the only way to reuse one that already exists, such as putting a shared call extension on more campaigns. Works with every extension type. Note a campaign can hold only one call extension.


App	Microsoft Ads
Operation ID	`microsoft_ads_apply_ad_extension_to_entities`
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 owns the ad extension.
`level`	string or SelectableOption	Yes	-	Where to attach the extension: ‘ACCOUNT’ applies it to every campaign, ‘CAMPAIGN’ to the campaigns listed below, ‘AD_GROUP’ to the ad groups.
`ad_extension_ids`	array of string or SelectItem	Yes	-	Existing ad extension IDs to attach. microsoft_ads_list_ad_extension_associations returns the IDs already in use on the account. Any extension type works: call, sitelink, callout, image, price, promotion and the rest.
`campaign_ids`	array of string or SelectItem	No	-	Campaigns to attach the extension to. Required when level is CAMPAIGN.
`ad_group_ids`	array of string or SelectItem	No	-	Ad groups to attach the extension to. Required when level is AD_GROUP.

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 how many associations were created and where. Fields: applied_associations, ad_extension_ids, entity_ids, association_type

Get Started

Guides

Operations

Apply Ad Extension To Entities

Inputs

MicrosoftAdsAccountItem

SelectItem

SelectableOption

Output

​Inputs

​MicrosoftAdsAccountItem

​SelectItem

​SelectableOption

​Output

Inputs

MicrosoftAdsAccountItem

SelectItem

SelectableOption

Output