<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/AdGroupUpdate",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:AdGroupUpdate"
  },
  "title" : "AdGroupUpdate"
}
-->

# AdGroupUpdate

The request body for updating an existing ad group.

```
object AdGroupUpdate
```

## 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

```json
{
  "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

[`object AdGroupUpdate.BidStrategy`](/documentation/Apple-Ads-Platform-API/AdGroupUpdate/BidStrategy-data.dictionary)

The request body for updating a bid strategy on an ad group or campaign.

[`object AdGroupUpdate.CpaCap`](/documentation/Apple-Ads-Platform-API/AdGroupUpdate/CpaCap-data.dictionary)

The deprecated request payload for updating a cost-per-acquisition goal. Use `bidStrategy` with `MAX_CONVERSIONS` instead.

[`object AdGroupUpdate.Targeting`](/documentation/Apple-Ads-Platform-API/AdGroupUpdate/Targeting-data.dictionary)

The targeting configuration for updating an existing ad group, specifying audience dimensions to include or exclude.

### Type Aliases

[`string AdGroupUpdate.Status`](/documentation/Apple-Ads-Platform-API/AdGroupUpdate/Status-data.typealias)

Advertiser-configurable serving status for an ad group.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)