Budgets

Create Budget

Creates a Budget

post/v2/budgets

Request

Base URL
https://api.brex.com
Auth
OAuth 2
Authorization codehttps://accounts-api.brex.com/oauth2/default/v1/authorize
Token URLhttps://accounts-api.brex.com/oauth2/default/v1/token
Scopesbudgets
TypeScript
https://skmtc.dev/brex-com/apis/budgets-api/docs/v2/budgets/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

Idempotency-Keystring required

Request body

namestring required

Name for the Budget.

descriptionstring required

Description of what the Budget is used for.

parent_budget_idstring required

ID of parent Budget.

owner_user_idsstring[] nullable

User IDs of the owners of the Budget.

period_recurrence_type'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'YEARLY' | 'ONE_TIME' required

Period type of the Budget e.g. MONTHLY.

limit_type'HARD' | 'SOFT' nullable

Whether the Budget amount blocks spend. HARD is rejected; use /v2/spend_limits for hard-auth limits.

start_datestring date nullable

The date when the Budget should start counting.

end_datestring date nullable

The date when the Budget should stop counting.

Example request

{
  "amount": {
    "amount": 700,
    "currency": "USD"
  }
}

Response

The Budget that was created

budget_idstring required

Unique ID for the Budget.

account_idstring required

The Brex account this Budget belongs to.