---
title: Create an Ad
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/post-ads
---

# 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/ads

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion This endpoint creates an ad that links an ad creative to an ad group. adGroupId and creativeId are 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 name and status. An ad group can contain multiple ads, but only one ad per ad group can be ENABLED at 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). Payload Examples

## See Also

- [Query Ads](apple-ads-platform-api/post-ads-query.md)
- [Get an Ad](apple-ads-platform-api/get-ads-_id_.md)
- [Update an Ad](apple-ads-platform-api/put-ads-_id_.md)
- [Delete an Ad](apple-ads-platform-api/delete-ads-_id_.md)