Inputs
MicrosoftAdsAccountItem
Output
Type:Dict
Returns the extension that was updated and which fields were sent.
Fields: ad_extension_id, type, updated_fieldsDocumentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Update an existing Microsoft Ads ad extension of any type, for example changing the phone number on a call extension or the text on a sitelink
| App | Microsoft Ads |
| Operation ID | microsoft_ads_update_ad_extension |
| Type | Action |
| Connection | microsoft_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Requires approval | Yes (write operation) |
| 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. |
extension | object or string | Yes | - | The ad extension object, as JSON, exactly as the Microsoft Advertising Campaign Management API version 13 defines it, sent unchanged to its UpdateAdExtensions operation. Carry the Id of the extension to change and its Type, plus the fields being changed. For example {“Type”: “CallAdExtension”, “Id”: 9964344458744, “CountryCode”: “GB”, “PhoneNumber”: “01420 561661”}. Microsoft requires the Type on every update, and treats some fields as required even when unchanged, such as CountryCode and PhoneNumber on a call extension, so send the full set for that type. The Type value is also the name of Microsoft’s data object, so searching their Campaign Management reference for that name shows which fields an update needs. Valid types: ActionAdExtension, AppAdExtension, CallAdExtension, CalloutAdExtension, FilterLinkAdExtension, FlyerAdExtension, ImageAdExtension, LocationAdExtension, LogoAdExtension, PriceAdExtension, PromotionAdExtension, ReviewAdExtension, SitelinkAdExtension, StructuredSnippetAdExtension. |
| 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. |
Dict
Returns the extension that was updated and which fields were sent.
Fields: ad_extension_id, type, updated_fields