---
title: Create a Budget Order
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/post-shared-budgets
---

# 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-budgets

## Response Codes

200 OK: Successful operation. Returns SharedBudgetResponse (result: SharedBudget). 400 Bad Request: Bad Request. Returns ErrorResponse. 401 Unauthorized: Unauthorized. 403 Forbidden: Forbidden. 404 Not Found: Resource not found. Returns ErrorResponse. 429 Too Many Requests: Rate Limit Exceeded. See Applying Rate Limits. 500 Internal Server Error: Internal Server Error. Returns ErrorResponse.

## Discussion

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. Payload Examples

## See Also

- [Get a Budget Order by ID](apple-ads-platform-api/get-shared-budgets-_id_.md)
- [Query Budget Orders](apple-ads-platform-api/post-shared-budgets-query.md)
- [Update a Budget Order](apple-ads-platform-api/put-shared-budgets-_id_.md)
- [Delete a Budget Order](apple-ads-platform-api/delete-shared-budgets-_id_.md)