Skip to content
Trakli Docs

Create a new transaction

POST
/transactions
 
curl --request POST \
  --url http://localhost:8000/api/v1/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form client_id=245cb3df-df3a-428b-a908-e5f74b8d58a3:245cb3df-df3a-428b-a908-e5f74b8d58a4 \
  --form amount=1 \
  --form type=income \
  --form intent=regular \
  --form description=example \
  --form datetime=2026-04-15T12:00:00Z \
  --form created_at=2026-04-15T12:00:00Z \
  --form party_id=1 \
  --form wallet_id=1 \
  --form group_id=1 \
  --form is_recurring=true \
  --form recurrence_period=daily \
  --form recurrence_interval=1 \
  --form recurrence_ends_at=2026-04-15T12:00:00Z \
  --form categories=1 \
  --form 'files[]=@file'

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type multipart/form-data
object
client_id

Unique identifier for your local client

string
Example 
245cb3df-df3a-428b-a908-e5f74b8d58a3:245cb3df-df3a-428b-a908-e5f74b8d58a4
amount
required
number format: float
type
required
string
Allowed values: income expense
intent
string
default: regular
Allowed values: regular loan_received loan_repayment debt_owed debt_settled investment_buy investment_return gift
description
string
datetime
string format: date-time
created_at
string format: date-time
party_id
integer
wallet_id
required
integer
group_id
integer
is_recurring

Set the transaction as a recurring transaction

boolean
recurrence_period

Set how often the transaction should repeat

string
Allowed values: daily weekly monthly yearly
recurrence_interval

Set how often the transaction should repeat

integer
recurrence_ends_at

When the transaction stops repeating

string format: date-time
categories
Array<integer>
files[]

Files to attach (jpg, jpeg, png, pdf; max 1.2MB each)

Array<string>

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Transaction created successfully

Media type application/json
object
id

ID of the transaction

integer
type
required

Type of the transaction (income or expense)

string
Allowed values: income expense
amount
required

Amount of the transaction

number format: float
description

Description of the transaction

string
datetime

Date and time of the transaction

string format: date
categories

List of categories of the transaction

Array<integer>
is_recurring

Set the transaction as a recurring transaction

boolean
user_id

ID of the user who created the transaction

integer
amount_in_budget_currency

Transaction amount converted to the currency of the budget

string
transfer_id

ID of the associated transfer, if any

integer
wallet_client_generated_id

Client-generated ID of the associated wallet

string format: uuid
party_client_generated_id

Client-generated ID of the associated party

string format: uuid
files

Files attached to the transaction

Array<object>
object
id

ID of the file

integer
path

Path or content of the file

string
link

URL to access the file

string
type

Type of file (image, icon, emoji, pdf)

string
Allowed values: image pdf icon emoji
model

Related model name

string
model_id

ID of the related model

integer
recurring_rules
object
id

ID of the transaction

integer
transaction_id

ID of the transaction

integer
recurrence_period

Set how often the transaction should repeat

string
recurrence_interval

Set how often the transaction should repeat

integer
recurrence_ends_at

When the transaction stops repeating

string format: date-time
next_scheduled_at

When next the transaction should happen

string format: date-time
Example 
{
  "type": "income",
  "files": [
    {
      "type": "image"
    }
  ]
}

400

Section titled “400 ”

Invalid input

403

Section titled “403 ”

Resource does not belong to user