Create an Ad
Creates a new ad that links an ad creative to an ad group for delivery.
URL
POST https://api.ads.apple.com/v1/adsHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | AdResponse | |
| 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 that links an ad creative to an ad group.
adGroupIdandcreativeIdare required at creation and are immutable: you can’t change them after creating the ad.The ad creative defines the visual content (product page or Apple Maps ad creative).
The ad controls the
nameandstatus.An ad group can contain multiple ads, but only one ad per ad group can be
ENABLEDat a time.
The ad’s displayStatus is an aggregate of campaign-level, ad group-level, and ad-level state, combined with ad creative eligibility.
The systemStatus will be NOT_RUNNING if the ad creative is in PENDING state (awaiting system validation, policy determination, or asset CDN availability), or if Apple has rejected the ad creative (INVALID).