Create transaction

Creates a manual evidence transaction (max 1000 per account). Bank/crypto synced txs cannot be created. By default applyToBalance adjusts the manual account balance.

POST/v1/create_transaction

Body

Field	Type	Required	Default	Description
idempotencyKey	string	Yes	—	Client-generated key (1–128 chars: letters, digits, . _ : -). Same key + same body replays; different body returns 409. Prefer Idempotency-Key HTTP header when calling the Tools API.
budgetId	string	Yes	—	Budget that owns the manual account.
accountId	string	Yes	—	Manual account to post the evidence transaction on.
amount	number	Yes	—	Signed amount (negative for outflows; ±1000000).
postedAt	string	Yes	—	ISO-8601 timestamp when the transaction posted.
currency	string	No	—	ISO 4217 currency code; defaults to the account currency.
description	string	No	—	Payee or memo text (max 100 characters).
applyToBalance	boolean	No	true	If true, adjusts the manual account balance when the transaction is created.

Response `data`

Field	Type	Description
id	string	New transaction id.
budgetId	string	Id of the budget this resource belongs to.
accountId	string	Id of the manual account.
source	string	Always `manual`.
amount	number	Amount in the relevant currency units.

Request

curl --request POST \
  --url https://api.getliquify.com/v1/create_transaction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"idempotencyKey":"req-1","budgetId":"bud_01","accountId":"acc_01","amount":-12.5,"postedAt":"2026-10-01T12:00:00.000Z","description":"Coffee"}'

{
  "ok": true,
  "data": {
    "id": "tx_02",
    "budgetId": "bud_01",
    "accountId": "acc_01",
    "source": "manual",
    "amount": -12.5
  }
}

Body

Response data

Related

Response `data`