Create Ad Accounts
Create a new ad account under a specified organization.
URL
POST https://api.ads.apple.com/v1/ad-accountsHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Optional | 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 creates a new ad account under a specified organization.
The ad account inherits
currency,timezone, andpaymentModelfrom the parent org at creation time. These values are immutable after creation, as is theorgIdrelationship.The
nameandproductFeaturesfields are both required. The system rejects the request if either is omitted.The
X-AP-Contextheader isn’t required for this endpoint.To enable App Store advertising, include a
CONTENT_PROVIDERdelegation with the CPID asresourceId.To enable Maps advertising, include a
BUSINESS_BRANDdelegation with the Brand ID asresourceId.See ProductFeatures for delegation requirements by App Store or Apple Maps.