Creates 1–30 expense boxes on a budget. Each row needs its own idempotencyKey (same namespace as create_box). Hard-fails at the 30-box plan cap. Counts as one write toward the rate limit.
POST
/v1/create_boxesBody
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| budgetId | string | Yes | — | Budget that will own the new boxes. |
| boxes | array | Yes | — | Rows of { idempotencyKey, name, type?, amount?, currency? } (1–30). |
Response data
| Field | Type | Description |
|---|---|---|
| results | array | Per-index create outcome (created / replayed / failed). |