Create a budget

budgetType

integer (enum)

Required

The type of budget. Allowed values: 1 = OperatingBudget, 2 = InvestmentBudget.

ownerReference

string, max 100

Required

The internal identifier (Reference/Code) of the owner whose financial administration this budget belongs to.

name

string, max 256

Required

The name of the budget. Stored on creation but not returned by Get a Budget.

calendarYear

integer

Required

The calendar year this budget applies to, for example 2026.

externalIdentifier

string, max 100, nullable

Optional

An external API identifier to associate with this budget, if the integrating system wants to track its own identifier for the record.

lines

array of objects

Required

The budget's line items. See sub-fields below.

lines.ledgerAccountCode

string, max 12

Required (within each line)

The general ledger account code this budget line applies to. Enforced: omitting this on a line returns a validation error.

lines.realEstateObjectReference

string, max 100, nullable

Optional

The internal identifier of the real estate object this budget line is allocated to, if the budget is broken down at the object level rather than only at the owner level. Must belong to a real estate object owned by the same ownerReference as the budget.

lines.month

integer, 0 to 12

Required (within each line)

The period this budget line applies to. Values 1 through 12 correspond to calendar months. 0 represents period 0, typically used for the starting balance of the financial year. Since 0 is also the default value when this field is omitted, omitting it is indistinguishable from explicitly setting it to period 0.

lines.amount

number (double)

Required (within each line)

The budgeted amount for this line, in the administration's base currency (major units, for example euros with decimals). The sign follows debit/credit convention relative to the ledger account referenced by ledgerAccountCode. Since 0 is also the default value when this field is omitted, omitting it is indistinguishable from explicitly setting it to zero.

reference

string, max 100, nullable

Optional

The internal identifier (Reference/Code) generated by Bloxs for the newly created budget.

externalIdentifier

string, max 100, nullable

Optional

The external API identifier for this budget, if one was supplied on creation.

budgetType

integer (enum), nullable

Optional

The type of budget. Allowed values: 1 = OperatingBudget, 2 = InvestmentBudget.

calendarYear

integer

Optional

The calendar year this budget applies to.

ownerReference

string, max 100

Required

The internal identifier (Reference/Code) of the owner whose financial administration this budget belongs to.

lastModified

string (date-time)

Optional

The date and time the budget was created, formatted as ISO 8601.

lines

array of objects, nullable

Optional

The budget's line items as stored. See sub-fields below.

lines.ledgerAccountCode

string, max 12

Required (within each line)

The general ledger account code this budget line applies to.

lines.realEstateObjectReference

string, max 100, nullable

Optional

The internal identifier of the real estate object this budget line is allocated to, if applicable.

lines.month

integer, 0 to 12

Required (within each line)

The period this budget line applies to.

lines.amount

number (double)

Required (within each line)

The budgeted amount for this line.