Delete an Ad Creative
Remove an ad creative by its unique identifier.
URL
DELETE https://api.ads.apple.com/v1/creatives/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string |
Header Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | Response | |
| 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 soft-deletes an ad creative: the system retains the ad creative record with deleted: true, but you can no longer use it to create new ads. The system automatically sets existing ads that reference the ad creative to systemStatus: NOT_RUNNING.
Deleted ad creatives can’t be restored. To use a similar ad creative, create a new ad creative with the same properties.
Understand the Impact on Ads
Deleting an ad creative affects all ads that reference it:
Effect | Detail |
|---|---|
Ads stop serving | All ads using this ad creative will have |
Ads are not deleted | The ads themselves aren’t deleted; only their delivery stops. |
Irreversible | Deleting an ad creative cannot be undone. Create a new ad creative to resume delivery. |
Keep these constraints in mind before issuing the delete request.
Constraint | Detail |
|---|---|
Soft delete | The system marks ad creative records deleted but retains them for audit and reporting purposes. |
Associated ads paused | All ads linked to a deleted ad creative stop serving immediately. |
Cannot delete already-deleted | Attempting to delete an already-deleted ad creative returns 404. |