<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Create-an-Ad-Group",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "rest:apple_ads:post:v5-campaigns-{}-adgroups"
  },
  "title" : "Create an Ad Group"
}
-->

# Create an Ad Group

Creates an ad group as part of a campaign.

## Discussion

To create ad groups, use the associated `campaignId` as a resource in the URI. In the request, specify [`TargetingDimensions`](/documentation/apple_ads/TargetingDimensions) and apply it to ad groups.

> Note:
> You can’t create or update ad groups with geotargeting for campaigns with multiple `countriesOrRegions`.

### Payload example: Create an ad group with targeting

**Request:**

```
POST https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups

{
  "campaignId": 56543219,
  "name": "TripTrek ad group",
  "cpaGoal": {
    "amount": "1",
    "currency": "USD"
  },
  "startTime": "2024-05-18T00:00:00.000",
  "endTime": "2024-05-22T00:00:00.000",
  "automatedKeywordsOptIn": true,
  "pricingModel": "CPC",
  "defaultBidAmount": {
    "amount": "1",
    "currency": "USD"
  },
 "targetingDimensions": {
    "age": {
      "included": [
        {
          "minAge": 20,
          "maxAge": 25
        }
      ]
    },
    "gender": {
      "included": [
        "F",
        "M"
      ]
    },
    "deviceClass": {
      "included": [
        "IPAD",
        "IPHONE"
        ]
    }
  },
  "orgId": 39879640,
  "status": "ENABLED"
}
```

**Response:**

```json
{
  "id": 542370642,
  "campaignId": 56543219,
  "name": "TripTrek ad group",
  "cpaGoal": {
    "amount": "1",
    "currency": "USD"
  },
  "startTime": "2024-05-18T00:00:00.000",
  "endTime": "2024-05-22T00:00:00.000",
  "automatedKeywordsOptIn": true,
  "pricingModel": "CPC",
  "defaultBidAmount": {
    "amount": "1",
    "currency": "USD"
  },
  "targetingDimensions": {
    "age": {
      "included": [
        {
          "minAge": 20,
          "maxAge": 25
        }
      ]
    },
    "gender": {
      "included": [
        "F",
        "M"
      ]
    },
    "country": null,
    "adminArea": null,
    "locality": null,
    "deviceClass": {
      "included": [
        "IPAD",
        "IPHONE"
        ]
    },
    "appDownloaders": null
  },
  "orgId": 40669820,
  "modificationTime": "2024-05-22T17:30:56.435",
  "status": "ENABLED",
  "servingStatus": "NOT_RUNNING",
  "servingStateReasons": [
    "START_DATE_IN_THE_FUTURE"
  ],
  "displayStatus": "ON_HOLD",
  "deleted": false
}
```

### Payload example: Create an ad group without targeting

**Request:**

```
POST https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups

{
  "name": "TripTrek ad group",
  "startTime": "2024-05-18T00:00:00.000",
  "endTime": "2024-05-22T00:00:00.000",
  "automatedKeywordsOptIn": false,
  "pricingModel": "CPC",
  "defaultBidAmount": {
    "amount": "1",
    "currency": "USD"
  },
  "orgId": 39879640,
  "status": "ENABLED"
}
```

**Response:**

```json
{
  "data": {
    "id": 586648342,
    "campaignId": 586640439,
    "name": "TripTrek ad group",
    "cpaGoal": null,
    "startTime": "2024-05-18T00:00:00.000",
    "endTime": "2024-05-22T00:00:00.000",
    "automatedKeywordsOptIn": false,
    "targetingDimensions": {
      "age": null,
      "gender": null,
      "country": null,
      "adminArea": null,
      "locality": null,
      "deviceClass": {
        "included": [
          "IPHONE",
          "IPAD"
        ]
      },
      "daypart": null,
      "appDownloaders": null
    },
    "orgId": 39879640,
    "creationTime": "2024-05-11T20:22:04.405",
    "pricingModel": "CPC",
    "modificationTime": "2024-05-11T20:22:04.405",
    "status": "ENABLED",
    "servingStatus": "NOT_RUNNING",
    "servingStateReasons": [
      "START_DATE_IN_THE_FUTURE"
    ],
    "displayStatus": "ON_HOLD",
    "deleted": false,
    "defaultBidAmount": {
      "amount": "1",
      "currency": "USD"
    }
  },
  "pagination": null,
  "error": null
}
```

### Payload example: Create an automated ad group in a campaign with a Maximize Conversions bid strategy

A Maximize Conversions campaign will return an error of `AUTOMATED_KEYWORDS_REQUIRED_AD_GROUP_MISSING` and not run until an automated ad group is created.

In automated ad groups:

- Search Match can’t be turned off.
- Audience settings and keywords can’t be edited but optional ad groups can be added to the campaign and include audience settings and keywords.
- Negative keywords can be added.

A Maximize Conversions bid strategy requires the use of Search Match and an automatically created ad group. See [`AdGroup`](/documentation/apple_ads/AdGroup) for more details on fields and see [Ad Groups](/documentation/Apple_Ads/ad-groups) for details on Search Match. See payload example in [`Create a Campaign`](/documentation/apple_ads/Create-a-Campaign) to create a Maximize Conversions campaign.

**Request:**

```
POST https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups

{
"name": "Automatic Ad Group",
"automatedKeywordsOptIn": true,
"pricingModel": "CPC",
"automatedKeywordsRequired": true,
"status": "ENABLED"
}
```

**Response:**

```json
{
    "data": {
        "id": 886958599,
        "campaignId": 886876955,
        "name": "Automatic Ad Group example3",
        "cpaGoal": null,
        "startTime": "2026-02-05T20:15:50.857",
        "endTime": null,
        "automatedKeywordsOptIn": true,
        "targetingDimensions": {
            "age": null,
            "gender": null,
            "country": null,
            "adminArea": null,
            "locality": null,
            "deviceClass": {
                "included": [
                    "IPHONE",
                    "IPAD"
                ]
            },
            "daypart": null,
            "appDownloaders": null,
            "appCategories": null
        },
        "orgId": 19173940,
        "creationTime": "2026-02-05T20:15:50.836",
        "pricingModel": "CPC",
        "modificationTime": "2026-02-05T20:15:50.871",
        "status": "ENABLED",
        "servingStatus": "RUNNING",
        "servingStateReasons": null,
        "displayStatus": "RUNNING",
        "deleted": false,
        "defaultBidAmount": {
            "amount": "0",
            "currency": "MXN"
        },
        "biddingStrategy": "MAX_CONVERSIONS",
        "automatedKeywordsRequired": true
    },
    "pagination": null,
    "error": null
}
```

### Payload example: Create an ad group with a campaign with a Maximize Conversions bid strategy

In maximize conversions campaigns:

- Bid values automatically managed and returned as `0`.
- Custom ads can be created in standard ad groups in both Maximize Conversions and manual campaigns.

**Request:**

```
POST https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups

{
  "name": "Ad Group",
  "pricingModel": "CPC",
  "status": "ENABLED",
  "startTime": "2025-12-03T15:16:03.728"
}
```

**Response:**

```json
{
    "data": {
        "id": 886958599,
        "campaignId": 886876955,
        "name": "Ad Group example3",
        "cpaGoal": null,
        "startTime": "2026-02-05T20:15:50.857",
        "endTime": null,
        "automatedKeywordsOptIn": true,
        "targetingDimensions": {
            "age": null,
            "gender": null,
            "country": null,
            "adminArea": null,
            "locality": null,
            "deviceClass": {
                "included": [
                    "IPHONE",
                    "IPAD"
                ]
            },
            "daypart": null,
            "appDownloaders": null,
            "appCategories": null
        },
        "orgId": 19173940,
        "creationTime": "2026-02-05T20:15:50.836",
        "pricingModel": "CPC",
        "modificationTime": "2026-02-05T20:15:50.871",
        "status": "ENABLED",
        "servingStatus": "RUNNING",
        "servingStateReasons": null,
        "displayStatus": "RUNNING",
        "deleted": false,
        "defaultBidAmount": {
            "amount": "0",
            "currency": "MXN"
        },
        "biddingStrategy": "MAX_CONVERSIONS",
        "automatedKeywordsRequired": true
    },
    "pagination": null,
    "error": null
}
```

---

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)