---
title: Delete an Ad Group
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/delete-adgroups-_id_
---

# Delete an Ad Group

Soft-delete an ad group by its unique identifier, along with all ads and keywords associated with it.

## URL

DELETE https://api.ads.apple.com/v1/adgroups/{id}

## Path Parameters

id:

## 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 deletes an ad group by its ID, using a soft delete: the system marks it deleted: true and preserves the record. By default, POST /adgroups/query results exclude it unless you filter with deleted EQUALS true. Deletion cascades to all resources nested under the ad group: it also marks ads, keywords, and negative keywords as deleted. This operation can’t be undone. Deleting an ad group has the following effects:  |   |   |   |   |  Payload Examples

## See Also

- [Create an Ad Group](apple-ads-platform-api/post-adgroups.md)
- [Query Ad Groups](apple-ads-platform-api/post-adgroups-query.md)
- [Get an Ad Group](apple-ads-platform-api/get-adgroups-_id_.md)
- [Update an Ad Group](apple-ads-platform-api/put-adgroups-_id_.md)