Contents

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

StatusReasonTypeDescription
200OK
Content-Type: application/json
SharedBudgetResponse

Successful operation. Returns SharedBudgetResponse (result: SharedBudget).

400Bad Request
Content-Type: application/json
ErrorResponse

Bad Request. Returns ErrorResponse.

401Unauthorized
Content-Type: application/json
ErrorResponse

Unauthorized.

403Forbidden
Content-Type: application/json
ErrorResponse

Forbidden.

404Not Found
Content-Type: application/json
ErrorResponse

Resource not found. Returns ErrorResponse.

429Too Many Requests
Content-Type: application/json
ErrorResponse

Rate Limit Exceeded. See Applying Rate Limits.

500Internal 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.

Payload Examples

See Also