Add Transaction Documentation

POST/events/{eventId}/transactions

Required Tokens

Field	Type	Required	Description
Bearer	Authorization: Bearer <api-key>	Optional	Your API key. Pass it as the Bearer token on every request.
Event token	x-Event-Token	Optional	Run Get Tokens in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually.

Creates a new transaction on the event. Transactions are double-entry: each one moves money from a debit account (source) to a credit account (destination). Both accounts must already exist on this event.

Creating a transaction automatically recalculates the balance and cash flow projections on both linked accounts.

Requires EventAccountingAdmin permission on the event.

Path Parameters

Field	Type	Required	Description
eventId	Guid	Required	The ID of the event.

Request Body

Field	Type	Required	Description
name	string	Required	The transaction's display name.
date	DateTime	Required	The date of the transaction.
state	string	Required	Initial state. One of: `Quoted`, `Committed`, `Paid`, `Excluded`.
debitAccount	Guid	Required	The ID of the account money flows out of. Must belong to this event.
creditAccount	Guid	Required	The ID of the account money flows into. Must belong to this event.
quotedAmount	int	Required	The estimated amount, in cents. Must be ≥ 0.
invoicedAmount	int	Required	The invoiced/committed amount, in cents. Must be ≥ 0. Use `0` when state is `Quoted`.
quoteFileId	Guid	Required	File ID for the quote document. Pass `00000000-0000-0000-0000-000000000000` if none.
invoiceFileId	Guid	Required	File ID for the invoice document. Pass `00000000-0000-0000-0000-000000000000` if none.

Transaction States

State	When to use
`Quoted`	Initial estimate. Set `invoicedAmount` to `0`.
`Committed`	Confirmed with an invoice. Populate `invoicedAmount`.
`Paid`	Money has moved. Contributes to account `balance`.
`Excluded`	Excluded from all projections and balance calculations.

Example Request

{
  "name": "Venue Deposit",
  "date": "2026-03-15T00:00:00Z",
  "state": "Quoted",
  "debitAccount": "acct-guid-001",
  "creditAccount": "acct-guid-002",
  "quotedAmount": 100000,
  "invoicedAmount": 0,
  "quoteFileId": "00000000-0000-0000-0000-000000000000",
  "invoiceFileId": "00000000-0000-0000-0000-000000000000"
}

Response

201 Created — No response body.

Error Codes

Code	HTTP Status	Description
`UNAUTHORIZED`	401	Missing or invalid token, or caller lacks `EventAccountingAdmin`.
`NOT_FOUND`	404	Debit or credit account not found on this event.
`BAD_REQUEST`	400	Invalid state, negative amount, or missing required field.