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
| 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 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:
Constraint | Detail |
|---|---|
Soft delete only | The system marks the ad group |
Cascade deletion | Deletion also marks all ads, keywords, and negative keywords belonging to the ad group as deleted. |
Excluded from query results by default |
|
Parent campaign deletion also deletes ad groups | Deleting a campaign cascades to all of its ad groups and their nested resources. |