Create Ad Group - Markifact

Create a Microsoft Ads ad group in a Search, Shopping, or Audience campaign. Detects the parent campaign type and omits unsupported Audience fields. Defaults to PAUSED; native settings support target-and-bid criteria.


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. The parent campaign is checked automatically: Audience groups omit type, language and network.
`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. Omitted for Audience campaigns, which use Audience Network.
`settings`	array of object or string	No	-	Native Microsoft AdGroup Settings array or JSON string. For Audience targeting, for example [{“Type”:“TargetSetting”,“Details”:[{“CriterionTypeGroup”:“Audience”,“TargetAndBid”:true}]}]. Without TargetAndBid, audience criteria are bid-only. Nested fields are forwarded unchanged.

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