Create Transaction
create_transactionRecord expenses, income, and transfers in Firefly III, including multi-split transactions, by specifying account, date, amount, and type.
Instructions
Record a new transaction (or multi-split transaction group) in Firefly III.
For an expense ('withdrawal'): specify your asset account via 'source_id' or 'source_name', and the merchant via 'destination_name' (or 'destination_id').
For income ('deposit'): specify the payer/revenue source via 'source_name' (or 'source_id'), and your asset account via 'destination_id' or 'destination_name'.
For a transfer ('transfer'): specify both 'source_id'/'source_name' and 'destination_id'/'destination_name' pointing to two of your own asset/liability accounts.
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": {
"transactions": "<transactions>"
},
"name": "create_transaction"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apply_rules | No | Whether Firefly III automation rules should run on this transaction. | |
| group_title | No | Title for the transaction group (recommended when creating a multi-split transaction). | |
| transactions | Yes | One split for a standard transaction, or multiple splits (all sharing the same 'type') for a split transaction. | |
| fire_webhooks | No | Whether Firefly III webhooks should fire for this transaction. | |
| error_if_duplicate_hash | No | Set true to reject the transaction if an identical transaction hash already exists. |