Create an Ad Group
Create a new ad group within a campaign, defining targeting, bid strategy, and scheduling for a set of ads.
URL
POST https://api.ads.apple.com/v1/adgroupsHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | AdGroupResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 404 | Not Found Content-Type: application/json | ErrorResponse | |
| 429 | Too Many Requests Content-Type: application/json | ErrorResponse | |
| 500 | Internal Server Error Content-Type: application/json | ErrorResponse |
Discussion
This endpoint creates an ad group that belongs to a single campaign via campaignId, which is required at creation and immutable afterward. The ad group defines its own targeting, bid strategy, and schedule, scoped within the campaign’s supply placement and budget.
The pricingModel field is also required: use CPT for tap-billed campaigns and CPM for impression-billed campaigns using the MANUAL_CPM bid strategy.