Create Responsive Search Ad - Markifact

Create responsive search ads (3-15 headlines, 2-4 descriptions, optional pinning) in Microsoft Ads ad groups.


App	Microsoft Ads
Operation ID	`microsoft_ads_create_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 group.
`update_type`	string or SelectableOption	Yes	-	Choose whether to create a single responsive search ad or multiple at once. Options: ‘single’ or ‘bulk’.
`ad_group_id`	string or SelectItem	No	-	The ad group ID to add the ad to (must be a Search ‘SearchStandard’ ad group). Required for single create.
`headlines`	array of string or object	No	-	List of headlines (3-15 items, max 30 final characters each). Each item is a string or an object with ‘text’ and optional ‘pinned_field’ (HEADLINE_1, HEADLINE_2, HEADLINE_3). Supports dynamic text strings like {keyword}. Required for single create.
`descriptions`	array of string or object	No	-	List of descriptions (2-4 items, max 90 final characters each). Each item is a string or an object with ‘text’ and optional ‘pinned_field’ (DESCRIPTION_1, DESCRIPTION_2). Supports dynamic text strings like {keyword}. Required for single create.
`final_url`	string	No	-	The landing page URL (must start with http:// or https://). Required for single create.
`path_1`	string	No	-	First display path appended to the domain (optional, max 15 final characters).
`path_2`	string	No	-	Second display path (optional, max 15 final characters). Can only be set if path_1 is set.
`ad_status`	string or SelectableOption	No	-	Initial ad status. Options: ACTIVE or PAUSED. Defaults to PAUSED.
`structured_data`	array (also accepts a comma-separated string)	No	-	Structured data for bulk create. Required columns: ‘ad_group_id’, ‘final_url’, ‘headlines’ (list of strings or {text, pinned_field} objects), ‘descriptions’ (same). Optional: ‘path_1’, ‘path_2’, ‘ad_status’ (defaults to PAUSED). Required for bulk create.

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 created responsive search ads including their ad IDs. Fields: message, created_count, results