Update Responsive Search Ad - Markifact

Update existing Microsoft Ads responsive search ads (headlines, descriptions, final URL, paths, status). Only provided fields are changed.


App	Microsoft Ads
Operation ID	`microsoft_ads_update_responsive_search_ad`
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.
`update_type`	string or SelectableOption	Yes	-	Choose whether to update a single responsive search ad or multiple at once. Options: ‘single’ or ‘bulk’.
`ad_group_id`	string or SelectItem	No	-	The ad group ID that contains the ad. Required for single update.
`ad_id`	string or SelectItem	No	-	The ID of the responsive search ad to update. Required for single update.
`headlines`	array of string or object	No	-	New full list of headlines (3-15 items, max 30 chars each; replaces existing). Each item is a string or {text, pinned_field: HEADLINE_1/2/3}. Omit to keep existing.
`descriptions`	array of string or object	No	-	New full list of descriptions (2-4 items, max 90 chars each; replaces existing). Each item is a string or {text, pinned_field: DESCRIPTION_1/2}. Omit to keep existing.
`final_url`	string	No	-	New landing page URL (http/https). Omit to keep existing.
`path_1`	string	No	-	New first display path (max 15 chars). Omit to keep existing.
`path_2`	string	No	-	New second display path (max 15 chars). Omit to keep existing.
`ad_status`	string or SelectableOption	No	-	New ad status. Options: ACTIVE or PAUSED. Omit to keep existing.
`structured_data`	array (also accepts a comma-separated string)	No	-	Structured data for bulk update. Required columns: ‘ad_group_id’, ‘ad_id’. Optional editable columns: ‘headlines’, ‘descriptions’, ‘final_url’, ‘path_1’, ‘path_2’, ‘ad_status’. Only provided fields are updated. Required for bulk update.

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 updated responsive search ads and which fields changed. Fields: message, updated_count, results