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

# Create Ad Accounts

Create a new ad account under a specified organization.

## Discussion

This endpoint creates a new ad account under a specified organization.

- The ad account inherits `currency`, `timezone`, and `paymentModel` from the parent org at creation time. These values are immutable after creation, as is the `orgId` relationship.
- The `name` and `productFeatures` fields are both required. The system rejects the request if either is omitted.
- The `X-AP-Context` header isn’t required for this endpoint.
- To enable App Store advertising, include a `CONTENT_PROVIDER` delegation with the CPID as `resourceId`.
- To enable Maps advertising, include a `BUSINESS_BRAND` delegation with the Brand ID as `resourceId`.
- See [`ProductFeatures`](/documentation/Apple-Ads-Platform-API/ProductFeatures) for delegation requirements by App Store or Apple Maps.

## Payload Examples

**Request with CPID Delegation:**

Links the ad account to an App Store Connect account via a Content Provider ID (CPID). The `delegations` field is optional but when included, each entry requires `resourceId` and `resourceType`.

### Request

```json
POST /v1/ad-accounts

{
 "name": "AwayFinder Ad Account",
 "productFeatures": [
   "APPSTORE_APP_MANUAL"
 ],
 "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",
   "systemStatusReasons": [],
   "productFeatures": [
     "APPSTORE_APP_MANUAL"
   ],
   "delegations": [
     {
       "resourceId": "12345678",
       "resourceType": "CONTENT_PROVIDER",
       "resourceName": "AwayFinder Apps"
     }
   ],
   "creationTime": "2025-01-10T08:00:00.000",
   "modificationTime": "2025-01-10T08:00:00.000"
 }
}
```

**Request with Maps Delegation:**

Links the ad account to a validated brand for Apple Maps advertising via a Brand ID. The `productFeatures` field must include `BUSINESS_BRAND_MANUAL` and the matching delegation must use `resourceType: BUSINESS_BRAND`.

### Request

```json
POST /v1/ad-accounts

{
 "name": "AwayFinder Brand Ad Account",
 "productFeatures": [
   "BUSINESS_BRAND_MANUAL"
 ],
 "delegations": [
   {
     "resourceId": "9876543",
     "resourceType": "BUSINESS_BRAND"
   }
 ]
}
```

### Response

```json
{
 "result": {
   "id": 123456790,
   "name": "AwayFinder Brand Ad Account",
   "orgId": 987654321,
   "timezone": "America/New_York",
   "currency": "USD",
   "paymentModel": "PAYG",
   "systemStatus": "ACTIVE",
   "systemStatusReasons": [],
   "productFeatures": [
     "BUSINESS_BRAND_MANUAL"
   ],
   "delegations": [
     {
       "resourceId": "9876543",
       "resourceType": "BUSINESS_BRAND",
       "resourceName": "AwayFinder"
     }
   ],
   "creationTime": "2025-01-10T08:00:00.000",
   "modificationTime": "2025-01-10T08: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)