---
title: Create an Ad Group
framework: Apple Ads
role: symbol
role_heading: Web Service Endpoint
platforms: [search ads 5.0+]
path: apple_ads/create-an-ad-group
---

# Create an Ad Group

Creates an ad group as part of a campaign.

## URL

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

## Path Parameters

campaignId: The unique identifier for the campaign.

## Response Codes

200 OK: If the call succeeds, the API returns the AdGroup object in the response payload with an HTTP status code of 200(OK). If unsuccessful, the HTTP status code indicates the error with details in the error message. 400 Bad Request: An invalid query or missing required parameters. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 404 Not Found: The API can’t locate the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later.

## Mentioned in

Apple Ads Campaign Management API 5

## Discussion

Discussion To create ad groups, use the associated campaignId as a resource in the URI. In the request, specify 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 Payload example: Create an ad group without targeting 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 for more details on fields and see Ad Groups for details on Search Match. See payload example in Create a Campaign to create a Maximize Conversions campaign. 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.

## HTTP Body

The request body that includes the details of the ad group and campaign.

## See Also

### Ad Group Endpoints

- [Find Ad Groups](apple_ads/find-ad-groups.md)
- [Find Ad Groups (org-level)](apple_ads/find-ad-groups-(org-level).md)
- [Get an Ad Group](apple_ads/get-an-ad-group.md)
- [Get all Ad Groups](apple_ads/get-all-ad-groups.md)
- [Update an Ad Group](apple_ads/update-an-ad-group.md)
- [Delete an Ad Group](apple_ads/delete-an-ad-group.md)