---
title: Update 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/put-adgroups-_id_
---

# Update an Ad Group

Update an existing ad group’s name, status, bid strategy, targeting, or scheduling.

## URL

PUT 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 updates an existing ad group. Only include the fields you want to modify. See the Determine Which Fields You Can Update section below to confirm which fields you can change. For ad groups under an auto-bidding campaign, see AdGroupUpdate.BidStrategy for how to echo the campaign’s bid strategy so the API doesn’t reject a GET-then-PUT round trip. Determine Which Fields You Can Update To change any field marked Yes below, use this endpoint. Fields marked No are either only settable at creation via Create an Ad Group or are system-computed. Sending them in an update request has no effect. See the Notes column for which applies to a given field. The cpaCap field is marked Deprecated: the API still accepts it on update for backward compatibility, but new integrations should use bidStrategy instead.  |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |  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)
- [Delete an Ad Group](apple-ads-platform-api/delete-adgroups-_id_.md)