Create Ad Group

Create a SearchStandard Microsoft Ads ad group inside an existing campaign

Create a SearchStandard Microsoft Ads ad group inside an existing campaign. Supports initial status, network, language, and optional CPC bid.

App	Microsoft Ads
Operation ID	microsoft_ads_create_ad_group
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 to create an ad group in.
campaign_id	string or SelectItem	Yes	-	Select the campaign to create the ad group in.
ad_group_name	string	Yes	-	Name for the new ad group.
status	string or SelectableOption	No	PAUSED	Initial ad group status. Default: PAUSED.
ad_group_type	string or SelectableOption	No	SearchStandard	Ad group type. Use SearchStandard (default) for ad groups in Search campaigns, or Shopping for ad groups in Shopping campaigns. Microsoft does not accept an explicit type for Shopping ad groups, so choosing Shopping omits the type and the campaign determines it.
cpc_bid	number or string	No	-	Optional max CPC bid in the account currency, for example 2.5.
language	string or SelectableOption	No	-	Optional ad group language. If omitted, Microsoft uses campaign-level languages when available. Example: English or Arabic.
network	string or SelectableOption	No	OwnedAndOperatedAndSyndicatedSearch	Optional search network. Default: OwnedAndOperatedAndSyndicatedSearch.

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 Microsoft Ads ad group.

Fields: ad_group_id, ad_group_name, campaign_id, status, ad_group_type, network, language