create_transaction
Create a new transaction (income, expense, or transfer). Requires accountId, amount (decimal), transactionType, and transferNature. paymentType is optional and defaults to the default payment type of the account. For transfers, also provide destinationAccountId and destinationAmount. Use splits to categorize portions of the amount. Use originalAmount + originalCurrencyCode to record what the purchase cost in its invoice currency when that differs from the account currency. Use paymentLegs to pay one purchase from several accounts. Use payeeId to link an existing payee, or merchantName to let the server resolve a payee from a raw merchant name (it matches an existing payee by name or alias and follows the instance's normal promotion rules, so it may not create a payee on first sight); the two cannot be combined. Requires finance:write scope.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"accountId": "<accountId>",
"amount": "<amount>",
"transactionType": "<transactionType>",
"transferNature": "<transferNature>"
},
"name": "create_transaction"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Optional note or description for the transaction | |
| time | No | Transaction date/time as ISO 8601 string. Defaults to now | |
| amount | Yes | Transaction amount as an unsigned decimal (e.g. 12.50). Never negative: transactionType sets the direction | |
| splits | No | Split the transaction across multiple categories. Each item: { categoryId, amount (decimal, greater than 0), note (optional) } | |
| tagIds | No | Tag IDs to assign to this transaction | |
| payeeId | No | ID of an existing payee to link (from get_payees). Cannot be combined with merchantName | |
| location | No | Where it happened: { latitude, longitude } in degrees | |
| accountId | Yes | ID of the account the transaction belongs to | |
| isPlanned | No | Mark the transaction as planned rather than an already-happened record | |
| categoryId | No | Category ID to assign to this transaction | |
| externalUrl | No | http(s) link to the source document, e.g. an invoice (max 2048 characters) | |
| payeeLocked | No | true pins the payee so later automations and bank sync never change it | |
| paymentLegs | No | Pay this income/expense from up to 4 more accounts. Each item is either { accountId, amount } to create a part on another account, or { transactionId } to link an existing transaction as a part (its amount stays). amount is in that account's currency; when it differs from this transaction's currency also pass paymentAmount, the part's value in this transaction's currency. Not allowed for transfers, refunds, planned or category-split transactions | |
| paymentType | No | Payment method used. Defaults to the account's default payment type, or bankTransfer | |
| merchantName | No | Raw merchant name, resolved to a payee the way bank sync and imports do: an existing payee is matched by name or alias, and a new one is created only once the name has repeated enough (the instance promotion rule). Cannot be combined with payeeId | |
| originalAmount | No | Amount in the currency the purchase was originally priced in (decimal), e.g. 66.42 for a PLN invoice paid from a UAH account. Informational only: never affects balances. Requires originalCurrencyCode | |
| transferNature | Yes | Transfer type. Use not_transfer for regular income/expense | |
| transactionType | Yes | Whether this is income or expense | |
| applyAutomations | No | true runs the user's enabled automation rules on this transaction. Default false | |
| excludeFromStats | No | Keep the transaction out of every spending/income report. It still counts toward balances and stays in the transaction list | |
| destinationAmount | No | For transfers: amount received in destination account (decimal, greater than 0) | |
| externalReference | No | External reference such as an invoice or order number (max 255 characters) | |
| destinationAccountId | No | For transfers: destination account ID | |
| originalCurrencyCode | No | ISO 4217 code of originalAmount (e.g. "PLN"). Requires originalAmount. Cannot be combined with transfer fields | |
| destinationTransactionId | No | For transfers: link to an existing destination transaction instead of creating one |