<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/POST-shared-budgets",
  "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:shared-budgets"
  },
  "title" : "Create a Budget Order"
}
-->

# Create a Budget Order

Creates a budget order that can be assigned to campaigns within an ad account.

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

**Create a Budget Order:**

### Request

Creates a $20,000 budget order for Q3 2026, active from July through September.

```json
{
 "name": "AwayFinder - Q3 2026 Budget",
 "startTime": "2026-07-01T00:00:00.000",
 "endTime": "2026-09-30T23:59:59.000",
 "value": {
   "amount": "20000.00",
   "currency": "USD"
 },
 "adAccountIds": [
   123456789
 ],
 "invoiceDetail": {
   "name": "AwayFinder Q3 2026 Invoice",
   "primaryBuyerName": "Jane Smith",
   "primaryBuyerEmail": "jane.smith@awayfinder.com",
   "billingEmail": "billing@awayfinder.com"
 }
}
```

### Response

```json
{
 "result": {
   "id": 777890001,
   "name": "AwayFinder - Q3 2026 Budget",
   "startTime": "2026-07-01T00:00:00.000",
   "endTime": "2026-09-30T23:59:59.000",
   "value": {
     "amount": "20000.00",
     "currency": "USD"
   },
   "adAccountIds": [
     123456789
   ],
   "systemStatus": "ACTIVE",
   "systemStatusReasons": [],
   "invoiceDetail": {
     "primaryBuyerName": "Jane Smith",
     "primaryBuyerEmail": "jane.smith@awayfinder.com",
     "billingEmail": "billing@awayfinder.com"
   },
   "deleted": false,
   "creationTime": "2026-06-06T10:00:00.000",
   "modificationTime": "2026-06-06T10: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)