Sign in
latestOpenAPI 3.0.12026-08-08175166.0 KB

e93b1cd07aaf

Budgets

Create Budget

Creates a Budget

post/v2/budgets

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.

namestring required

Name for the Budget.

descriptionstring nullable

Description of what the Budget is used for.

parent_budget_idstring nullable

ID of parent Budget.

owner_user_idsstring[] required

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.

start_datestring date nullable

The date when the Budget should start counting.

end_datestring date nullable

The date when the Budget should stop counting.

spend_budget_status'ACTIVE' | 'ARCHIVED' | 'DELETED' | 'EXPIRED' required

Status of the Budget e.g. ACTIVE.

limit_type'HARD' | 'SOFT' nullable

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

Example response

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