Create Ad Group - Markifact

Creates a new ad group under a campaign in the connected OpenAI Ads account.


App	OpenAI Ads
Operation ID	`openai_ads_create_ad_group`
Type	Action
Connection	`openai_ads` (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`campaign_id`	string or SelectableOption	Yes	-	Parent campaign ID to create the ad group under (from openai_ads_list_campaigns).
`name`	string	Yes	-	Ad group name (3-1000 characters).
`status`	string or SelectableOption	Yes	-	Ad group status: ‘active’ or ‘paused’.
`billing_event_type`	string or SelectableOption	Yes	-	Bid / billing event type. Must match the parent campaign’s objective: ‘click’ (CPC) for a clicks campaign, ‘impression’ (CPM) for an impressions campaign, ‘conversion’ for a conversions campaign.
`bid_amount`	number	Yes	-	Maximum bid in account currency (e.g. US dollars), i.e. 1.50 for $1.50. This value is converted to micros automatically before sending to the API.
`context_hints`	string or array of string	No	-	Optional context hints — conversations, topics, or keywords where your products or services may be relevant. These guide matching but aren’t exact-match targeting. Provide one hint per line, or as a list.
`product_feed_id`	string	No	-	Product feed ID, shown in the Feeds area of OpenAI Ads Manager (there is no API to list feeds). Required when the parent campaign’s mode is ‘product_feed’; the ad group then advertises items from this feed.
`product_filters`	string or array of OpenAIAdsProductFilterItem	No	-	Optional filters narrowing which feed items this ad group advertises (e.g. only a brand, or price above a threshold). A JSON list of {“field”, “operator”, “values”} objects, e.g. [{“field”: “brand”, “operator”: “in”, “values”: [“Acme”]}, {“field”: “price”, “operator”: “gt”, “values”: [“25.00”]}]. Only valid together with product_feed_id; filters are ANDed.
`description`	string	No	-	Optional ad group description.

OpenAIAdsProductFilterItem

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	Feed attribute to filter on.
`operator`	string or SelectableOption	Yes	-	‘in’ matches any of the values; ‘gt’/‘gte’/‘lt’/‘lte’ are numeric comparisons, allowed only on ‘price’ and ‘star_rating’.
`values`	string or array of string	No	-	Values to match — a list or a comma-separated string. Numbers are sent as strings (e.g. ‘25.00’).
`value`	string or array of string	No	-

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns the created ad group object exactly as returned by the OpenAI Ads API (id, name, status, bidding_config, context_hints, description, product_set, campaign_id, created_at, updated_at). Fields: dynamic (depend on the inputs) Example:

{
  "id": "adgrp_...",
  "campaign_id": "cmpn_...",
  "name": "US English",
  "status": "active",
  "bidding_config": {
    "billing_event_type": "click",
    "max_bid_micros": 3500000
  },
  "context_hints": [
    "productivity"
  ]
}