Create Callouts

Create callout ad extensions and attach them to Microsoft Ads entities at account, campaign, or ad group level

Create callout ad extensions and attach them to Microsoft Ads entities at account, campaign, or ad group level

App	Microsoft Ads
Operation ID	microsoft_ads_create_callouts
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, ask user for it if not provided
level	string or SelectableOption	Yes	-	Choose where to attach the callouts. Available options: ‘ACCOUNT’, ‘CAMPAIGN’, ‘AD_GROUP’
campaign_ids	array of string or SelectItem	No	-	Select one or more campaigns to attach the callouts (required if level is CAMPAIGN)
ad_group_ids	array of string or SelectItem	No	-	Select one or more ad groups to attach the callouts (required if level is AD_GROUP)
callout_texts	array of string	Yes	-	List of callout texts. Each callout must be max 25 characters.
start_date	integer or string	No	-	Start date for when the callouts can begin serving (Unix timestamp or YYYY-MM-DD format)
end_date	integer or string	No	-	End date for when the callouts stop serving (Unix timestamp or YYYY-MM-DD format)

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 created callouts details.

Fields: callout_ids, callouts_created