> ## Documentation Index > Fetch the complete documentation index at: https://docs.markifact.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Ad Group > Creates a Reddit Ads ad group in a campaign with budget, bidding, schedule, and targeting (geos, communities, interests, keywords, devices, custom audiences) Creates a Reddit Ads ad group in a campaign with budget, bidding, schedule, and targeting (geos, communities, interests, keywords, devices, custom audiences). For CBO campaigns leave budget and bidding unset to inherit from the campaign. Money amounts are in the account currency, not micros. Ad groups are created PAUSED by default and require a conversion pixel ID. | | | | --------------------- | ---------------------------- | | **App** | Reddit Ads | | **Operation ID** | `reddit_ads_create_ad_group` | | **Type** | Action | | **Connection** | `reddit_ads` (required) | | **Credits per run** | 2 | | **Agent / MCP tool** | Yes | | **Requires approval** | Yes (write operation) | ## Inputs | Field | Type | Required | Default | Description | | ------------------------------ | -------------------------- | -------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `account` | DynamicAccount | Yes | - | Select the Reddit Ads account that owns the campaign. | | `campaign_id` | string or SelectItem | Yes | - | ID of the Reddit Ads campaign to create the ad group in. | | `ad_group_name` | string | Yes | - | Name of the ad group. | | `status` | string or SelectableOption | No | `PAUSED` | Initial ad group status. Options: 'ACTIVE', 'PAUSED'. Default: 'PAUSED'. | | `conversion_pixel_id` | string | Yes | - | Reddit Pixel ID used for measurement, for example 't2\_123456'. Reddit requires this for all ad groups. | | `goal_type` | string or SelectableOption | No | - | Budget goal type. Options: 'DAILY\_SPEND', 'LIFETIME\_SPEND'. Leave unset for campaigns with campaign budget optimization (CBO) to inherit the campaign's setting. | | `goal_value` | number | No | - | Ad group budget in the account currency (converted to microcurrency automatically), daily or lifetime per goal\_type. Leave unset for CBO campaigns; the campaign manages the budget. | | `bid_strategy` | string or SelectableOption | No | - | Bid strategy. Options: 'BIDLESS', 'MANUAL\_BIDDING', 'MAXIMIZE\_VOLUME', 'TARGET\_CPX'. In the Reddit Ads UI, 'BIDLESS' is called Lowest Cost and 'MAXIMIZE\_VOLUME' is called Cost Cap. For CBO campaigns leave unset to inherit the campaign's strategy. | | `bid_type` | string or SelectableOption | No | - | Bid type, which must fit the optimization goal and campaign objective. Options: 'CPC', 'CPM', 'CPV', 'CPV6'. For CBO campaigns leave unset to inherit the campaign's bid type. | | `bid_value` | number | No | - | Amount to pay per bidding event in the account currency (converted to microcurrency automatically). Reddit requires between 3.50 and 100 USD when bid\_type is CPM. | | `optimization_goal` | string or SelectableOption | No | - | The event to optimize for; cannot be changed later. Must match the campaign's optimization goal for CBO campaigns, and can be left unset for conversions or app installs objectives to default from the campaign. Common values: 'PURCHASE', 'SIGN\_UP', 'LEAD', 'PAGE\_VISIT', 'VIDEO\_VIEW\_6S'. | | `start_time` | string | No | - | When the ad group starts delivering, as ISO 8601 (for example 2026-08-01T00:00:00Z) or YYYY-MM-DD. When unset, delivery starts immediately (defaults to the current time). For ad groups in a campaign with a future start time, it must match or be later than the campaign start time. | | `end_time` | string | No | - | When the ad group stops delivering (ISO 8601 or YYYY-MM-DD). When unset, the ad group runs continuously. For CBO campaigns it must match or be earlier than the campaign's end time. | | `targeting` | object or string | No | - | Official Reddit Ads v3 ad group targeting object as JSON, sent as-is. Supported keys: geolocations / excluded\_geolocations (geolocation IDs), communities / excluded\_communities (subreddit names), interests / excluded\_interests, keywords / excluded\_keywords, custom\_audience\_ids / excluded\_custom\_audience\_ids, devices (objects with type DESKTOP or MOBILE, os ANDROID or IOS, min\_version, max\_version), platforms (ALL, DESKTOP, MOBILE\_NATIVE, MOBILE\_WEB), locations (FEED, COMMENTS\_PAGE), carriers, languages (ISO 639-1 codes), gender (FEMALE or MALE), view\_modes, and expand\_targeting (boolean). Example: \{"geolocations": \["US", "CA"], "communities": \["technology", "programming"], "platforms": \["MOBILE\_NATIVE"], "expand\_targeting": true}. For APP\_INSTALLS campaigns exactly one device must be targeted and at least one mobile platform included. | | `schedule` | array of object or string | No | - | Optional recurring weekly delivery windows as a JSON list, sent as-is. Each window has start\_day, start\_hour, end\_day, end\_hour with days 0 (Sunday) to 6 (Saturday) and hours 0-23 in the ad group timezone. Example: \[\{"start\_day": 1, "start\_hour": 9, "end\_day": 1, "end\_hour": 17}] | | `shopping_type` | string or SelectableOption | No | - | For shopping ads: the type of ads the ad group contains. Options: 'DYNAMIC', 'STATIC'. | | `shopping_targeting` | object or string | No | - | Official Reddit Ads v3 shopping targeting object as JSON for dynamic product ads, sent as-is. Keys: targeting\_type (PROSPECTING or RETARGETING), conversion\_event\_types / excluded\_conversion\_event\_types (ADD\_TO\_CART, ADD\_TO\_WISHLIST, PURCHASE, SEARCH, VIEW\_CONTENT), lookback\_window\_days. Example: \{"targeting\_type": "RETARGETING", "conversion\_event\_types": \["ADD\_TO\_CART"], "lookback\_window\_days": 30} | | `product_set_id` | string | No | - | Product set ID; required for CATALOG\_SALES ads to select products for dynamic ads or link a catalog for static ads. | | `saved_audience_id` | string | No | - | Optional saved audience ID to apply to the ad group. | | `app_id` | string | No | - | Apple App Store or Google Play app ID for APP\_INSTALLS campaigns. | | `optimization_strategy_type` | string or SelectableOption | No | - | Optional optimization strategy type. Options: 'DOWNSTREAM\_CONVERSIONS', 'APP\_INSTALLS'. | | `view_through_conversion_type` | string or SelectableOption | No | - | Conversion attribution window. Options: 'SEVEN\_DAY\_CLICKS', 'SEVEN\_DAY\_CLICKS\_ONE\_DAY\_VIEW'. Must be SEVEN\_DAY\_CLICKS\_ONE\_DAY\_VIEW for CATALOG\_SALES campaigns with the PURCHASE optimization goal; for CBO campaigns it must match the campaign's setting. | ### 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 ad group. **Fields**: `ad_group_id`, `ad_group_name`, `configured_status`, `effective_status`, `campaign_id`