Update Ad Accounts
Update an ad account’s name or delegations.
URL
PUT https://api.ads.apple.com/v1/ad-accounts/{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 | AdAccountResponse | Successful operation. Returns AdAccountResponse ( |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | Bad Request. Returns ErrorResponse. |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | Unauthorized. |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | Forbidden. |
| 404 | Not Found Content-Type: application/json | ErrorResponse | Resource not found. Returns ErrorResponse. |
| 429 | Too Many Requests Content-Type: application/json | ErrorResponse | Rate Limit Exceeded. See Applying Rate Limits. |
| 500 | Internal Server Error Content-Type: application/json | ErrorResponse | Internal Server Error. Returns ErrorResponse. |
Discussion
This endpoint updates an ad account’s name or delegations. See AdAccountUpdate for field-level mutability details.
The
delegationsfield is optional and nullable.When included, each entry requires a
resourceTypeand aresourceId.Like a promoted object, a delegation always identifies its resource by type and ID:
CONTENT_PROVIDERtakes a Content Provider ID (CPID), andBUSINESS_BRANDtakes a Brand ID. See AdvertiserResourceType for all supported values.Providing the
delegationsarray 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_PROVIDERdelegation with the CPID asresourceId. See ProductFeatures for delegation requirements by App Store or Apple Maps.