---
title: AdGroupUpdate
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/adgroupupdate
---

# AdGroupUpdate

The request body for updating an existing ad group.

## Declaration

```data
object AdGroupUpdate
```

## Properties

name: The advertiser-given name of this ad group. Mutable. startTime: The scheduled start date and time of this ad group in ISO 8601 format. Mutable. endTime: The scheduled end date and time. Omit to inherit the campaign end date. Mutable. automatedKeywordsOptIn: Opt in to Search Match, which automatically matches search terms without requiring explicit keywords. Mutable. status: Advertiser-configurable serving status. Use to pause (PAUSED) or resume (ENABLED) this ad group. See AdGroupStatus. Mutable. automatedKeywordsRequired: Immutable. Set at creation via AdGroupCreate. Any value sent here is ignored. bidStrategy: The bid strategy for this ad group. bidStrategyType and bidStrategyGoal must be sent together and matched per the pairings in BidStrategy. See AdGroupUpdate.BidStrategy and BidStrategyUpdate. Mutable. targeting: Audience and placement targeting configuration for this ad group. See AdGroupTargetingUpdate. Mutable. cpaCap: Deprecated. Still accepted on update for backward compatibility, but use bidStrategy with MAX_CONVERSIONS instead. See CPAGoalUpdate.

## Discussion

Discussion The AdGroupUpdate object is the request payload for modifying an existing ad group. Include only the fields you want to change. The pricingModel and automatedKeywordsRequired fields are immutable. To manage keywords and negative keywords, use the dedicated keyword endpoints. Example {   "name": "AwayFinder iOS — New Users 18-34",   "startTime": "2025-09-01T00:00:00.000",   "endTime": "2025-12-31T23:59:59.000",   "automatedKeywordsOptIn": false,   "status": "ENABLED",   "bidStrategy": {     "bidStrategyType": "MANUAL_CPT",     "bidStrategyGoal": "TAP",     "bid": {       "amount": "7.50",       "currency": "USD"     }   },   "targeting": {     "deviceClass": {       "include": [         "IPHONE"       ]     },     "minAge": {       "include": [         "18"       ]     },     "maxAge": {       "include": [         "34"       ]     }   } }

## Topics

### Dictionaries

- [AdGroupUpdate.BidStrategy](apple-ads-platform-api/adgroupupdate/bidstrategy-data.dictionary.md)
- [AdGroupUpdate.CpaCap](apple-ads-platform-api/adgroupupdate/cpacap-data.dictionary.md)
- [AdGroupUpdate.Targeting](apple-ads-platform-api/adgroupupdate/targeting-data.dictionary.md)

### Type Aliases

- [AdGroupUpdate.Status](apple-ads-platform-api/adgroupupdate/status-data.typealias.md)

## See Also

- [AdGroup](apple-ads-platform-api/adgroup.md)
- [AdGroupCreate](apple-ads-platform-api/adgroupcreate.md)
- [AdGroupResponse](apple-ads-platform-api/adgroupresponse.md)
- [AdGroupQueryResponse](apple-ads-platform-api/adgroupqueryresponse.md)
- [AdGroupTargeting](apple-ads-platform-api/adgrouptargeting.md)
- [AdGroupTargetingCreate](apple-ads-platform-api/adgrouptargetingcreate.md)
- [AdGroupTargetingUpdate](apple-ads-platform-api/adgrouptargetingupdate.md)
- [BidStrategy](apple-ads-platform-api/bidstrategy.md)
- [BidStrategyCreate](apple-ads-platform-api/bidstrategycreate.md)
- [BidStrategyUpdate](apple-ads-platform-api/bidstrategyupdate.md)
- [CPAGoal](apple-ads-platform-api/cpagoal.md)
- [CPAGoalCreate](apple-ads-platform-api/cpagoalcreate.md)
- [CPAGoalUpdate](apple-ads-platform-api/cpagoalupdate.md)
- [TargetingData](apple-ads-platform-api/targetingdata.md)
- [TargetingDataCreate](apple-ads-platform-api/targetingdatacreate.md)