<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/PUT-ad-accounts-_id_",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:put:ad-accounts-{}"
  },
  "title" : "Update Ad Accounts"
}
-->

# Update Ad Accounts

Update an ad account’s name or delegations.

## Discussion

This endpoint updates an ad account’s name or delegations. See [`AdAccountUpdate`](/documentation/Apple-Ads-Platform-API/AdAccountUpdate) for field-level mutability details.

- The `delegations` field is optional and nullable.
- When included, each entry requires a `resourceType` and a `resourceId`.
- Like a promoted object, a delegation always identifies its resource by type and ID: `CONTENT_PROVIDER` takes a Content Provider ID (CPID), and `BUSINESS_BRAND` takes a Brand ID. See [`AdvertiserResourceType`](/documentation/Apple-Ads-Platform-API/AdvertiserResourceType) for all supported values.
- Providing the `delegations` array replaces all existing delegations in full: the update keeps the items you include and removes the items you omit.
- To link an App Store Connect account, include a `CONTENT_PROVIDER` delegation with the CPID as `resourceId`. See [`ProductFeatures`](/documentation/Apple-Ads-Platform-API/ProductFeatures) for delegation requirements by App Store or Apple Maps.

## Payload Examples

**Update with CPID Delegation:**

All fields in the request body are optional. The `delegations` field is also nullable, but `name`, if provided, must not be null. Providing the `delegations` array replaces all existing delegations in full.

### Request

```json
PUT /v1/ad-accounts/123456789

{
 "delegations": [
   {
     "resourceId": "12345678",
     "resourceType": "CONTENT_PROVIDER"
   }
 ]
}
```

### Response

```json
{
 "result": {
   "id": 123456789,
   "name": "AwayFinder Ad Account",
   "orgId": 987654321,
   "timezone": "America/New_York",
   "currency": "USD",
   "paymentModel": "PAYG",
   "systemStatus": "ACTIVE",
   "delegations": [
     {
       "resourceId": "12345678",
       "resourceType": "CONTENT_PROVIDER",
       "resourceName": "AwayFinder"
     }
   ],
   "creationTime": "2025-01-10T08:00:00.000",
   "modificationTime": "2025-06-01T10:00:00.000"
 }
}
```

**Update with Brand ID Delegation:**

Renames the account and replaces the full set of delegations. All array fields use full-replacement semantics.

### Request

```json
PUT /v1/ad-accounts/123456789

{
 "name": "AwayFinder Ad Account Updated",
 "delegations": [
   {
     "resourceId": "9151314442816847872",
     "resourceType": "BUSINESS_BRAND"
   }
 ]
}
```

### Response

```json
{
 "result": {
   "id": 123456789,
   "name": "AwayFinder Ad Account Updated",
   "orgId": 987654321,
   "timezone": "America/New_York",
   "currency": "USD",
   "paymentModel": "PAYG",
   "systemStatus": "ACTIVE",
   "delegations": [
     {
       "resourceId": "9151314442816847872",
       "resourceType": "BUSINESS_BRAND",
       "resourceName": "AwayFinder"
     }
   ],
   "creationTime": "2025-01-10T08:00:00.000",
   "modificationTime": "2025-06-01T10:00:00.000"
 }
}
```

---

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)