<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/AdGroupCreate",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:AdGroupCreate"
  },
  "title" : "AdGroupCreate"
}
-->

# AdGroupCreate

The request body for creating a new ad group.

```
object AdGroupCreate
```

## Discussion

The `AdGroupCreate` object is the request payload for creating a new ad group via `POST /v1/adgroups` ([`Create an Ad Group`](/documentation/Apple-Ads-Platform-API/POST-adgroups)).

You can’t create keywords or negative keywords inline. Create the ad group first, then add keywords and negative keywords with separate calls.

### Example

```json
{
  "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

[`object AdGroupCreate.BidStrategy`](/documentation/Apple-Ads-Platform-API/AdGroupCreate/BidStrategy-data.dictionary)

The creation payload for configuring a bid strategy on an ad group or campaign.

[`object AdGroupCreate.CpaCap`](/documentation/Apple-Ads-Platform-API/AdGroupCreate/CpaCap-data.dictionary)

The deprecated request payload for setting a cost-per-acquisition goal. Use `bidStrategy` with `MAX_CONVERSIONS` instead.

[`object AdGroupCreate.Targeting`](/documentation/Apple-Ads-Platform-API/AdGroupCreate/Targeting-data.dictionary)

The targeting configuration for creating a new ad group, specifying audience dimensions to include or exclude.

### Type Aliases

[`string AdGroupCreate.PricingModel`](/documentation/Apple-Ads-Platform-API/AdGroupCreate/PricingModel-data.typealias)

The unit of ad delivery an ad group is charged for, independent of how the account funds spend.

[`string AdGroupCreate.Status`](/documentation/Apple-Ads-Platform-API/AdGroupCreate/Status-data.typealias)

Advertiser-configurable serving status for an ad group.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)