---
title: AdGroupCreate
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/adgroupcreate
---

# AdGroupCreate

The request body for creating a new ad group.

## Declaration

```data
object AdGroupCreate
```

## Properties

name: The advertiser-given name of this ad group. campaignId: The campaign this ad group belongs to. Immutable after creation. startTime: The scheduled start date and time of this ad group in ISO 8601 format. endTime: The scheduled end date and time. Omit to inherit the campaign end date. pricingModel: The pricing model for this ad group (CPA, CPM, or CPT). Must match the campaign’s billing event: CPT pairs with billingEvent: TAPS, CPM pairs with billingEvent: IMPRESSIONS. See PricingModel. Immutable after creation. automatedKeywordsOptIn: Auto opt-in for Search Match. When enabled, the system automatically targets additional relevant search terms beyond the explicit keyword list. status: Advertiser-configurable serving status. No default is applied when this field is omitted. See AdGroupStatus. automatedKeywordsRequired: Whether automated keyword generation is required for this ad group. bidStrategy: The bid strategy for this ad group. If omitted, the campaign-level bid strategy applies. See BidStrategyCreate. targeting: Audience and placement targeting for this ad group (device class, age, gender, location, etc.). See AdGroupTargetingCreate. cpaCap: Deprecated. Use bidStrategy with MAX_CONVERSIONS instead. See CPAGoalCreate.

## Discussion

Discussion The AdGroupCreate object is the request payload for creating a new ad group via POST /v1/adgroups (Create an Ad Group). You can’t create keywords or negative keywords inline. Create the ad group first, then add keywords and negative keywords with separate calls. Example {   "name": "AwayFinder iOS — New Users 18-34",   "campaignId": 444555666,   "startTime": "2025-09-01T00:00:00.000",   "endTime": "2025-12-31T23:59:59.000",   "pricingModel": "CPT",   "automatedKeywordsOptIn": false,   "status": "ENABLED",   "automatedKeywordsRequired": false,   "bidStrategy": {     "bidStrategyType": "MANUAL_CPT",     "bidStrategyGoal": "TAP",     "bid": {       "amount": "2.50",       "currency": "USD"     }   },   "targeting": {     "deviceClass": {       "include": [         "IPHONE"       ]     },     "minAge": {       "include": [         "18"       ]     },     "maxAge": {       "include": [         "34"       ]     },     "appDownloader": {       "include": [         "123456789"       ]     }   } }

## Topics

### Dictionaries

- [AdGroupCreate.BidStrategy](apple-ads-platform-api/adgroupcreate/bidstrategy-data.dictionary.md)
- [AdGroupCreate.CpaCap](apple-ads-platform-api/adgroupcreate/cpacap-data.dictionary.md)
- [AdGroupCreate.Targeting](apple-ads-platform-api/adgroupcreate/targeting-data.dictionary.md)

### Type Aliases

- [AdGroupCreate.PricingModel](apple-ads-platform-api/adgroupcreate/pricingmodel-data.typealias.md)
- [AdGroupCreate.Status](apple-ads-platform-api/adgroupcreate/status-data.typealias.md)

## See Also

- [AdGroup](apple-ads-platform-api/adgroup.md)
- [AdGroupUpdate](apple-ads-platform-api/adgroupupdate.md)
- [AdGroupResponse](apple-ads-platform-api/adgroupresponse.md)
- [AdGroupQueryResponse](apple-ads-platform-api/adgroupqueryresponse.md)
- [AdGroupTargeting](apple-ads-platform-api/adgrouptargeting.md)
- [AdGroupTargetingCreate](apple-ads-platform-api/adgrouptargetingcreate.md)
- [AdGroupTargetingUpdate](apple-ads-platform-api/adgrouptargetingupdate.md)
- [BidStrategy](apple-ads-platform-api/bidstrategy.md)
- [BidStrategyCreate](apple-ads-platform-api/bidstrategycreate.md)
- [BidStrategyUpdate](apple-ads-platform-api/bidstrategyupdate.md)
- [CPAGoal](apple-ads-platform-api/cpagoal.md)
- [CPAGoalCreate](apple-ads-platform-api/cpagoalcreate.md)
- [CPAGoalUpdate](apple-ads-platform-api/cpagoalupdate.md)
- [TargetingData](apple-ads-platform-api/targetingdata.md)
- [TargetingDataCreate](apple-ads-platform-api/targetingdatacreate.md)