Create a Budget Order
Creates a budget order that can be assigned to campaigns within an ad account.
URL
POST https://api.ads.apple.com/v1/shared-budgetsResponse Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | SharedBudgetResponse | Successful operation. Returns SharedBudgetResponse ( |
| 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. See Budget Orders Endpoints for |
| 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 budget order that campaigns can draw from via SharedBudgetAssignment. With a budget order, total spend across all assigned campaigns can’t exceed the budget order’s value, providing centralized cost control across a campaign group.
Omit the X-AP-Context header. This endpoint requires organization-level permissions, and the API returns 403 Forbidden if you send an ad account header. See Budget Orders Endpoints.