Skip to main content
POST
Create transaction

Authorizations

X-Api-Key
string
header
required

API key for authentication. Generate one from your account settings.

Body

application/json
transaction
object
required

Response

transaction created

id
string<uuid>
required
date
string<date>
required
amount
string
required

Localized, formatted amount string (e.g. "$50.00")

amount_cents
integer
required

Absolute amount in minor currency units (e.g. 5000 for $50.00 USD). Uses the currency's minor-unit conversion factor.

Required range: x >= 0
signed_amount_cents
integer
required

Signed amount in minor currency units. Positive for income, negative for expenses.

currency
string
required
name
string
required
classification
enum<string>
required
Available options:
income,
expense
account
object
required
tags
object[]
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
notes
string | null
category
object | null
merchant
object | null
transfer
object | null