API

Create expenses

Batch-create 1–100 planned expenses in a box.

Creates 1–100 planned expenses in a box. Each row needs its own idempotencyKey (same namespace as create_expense). Optional matchingGroup per row. Hard-fails at the 100-expense plan cap.

POST/v1/create_expenses

Body

FieldTypeRequiredDefaultDescription
budgetIdstringYes—Budget that owns the box.
boxIdstringYes—Box that will contain the expenses.
expensesarrayYes—Rows of { idempotencyKey, name, amount?, …, matchingGroup? } (1–100).

Response data

FieldTypeDescription
resultsarrayPer-index create outcome.