Create Account
create_accountAdd a new Firefly III account for assets, expenses, revenue, liabilities, or cash, including optional account roles and liability details.
Instructions
Create a new account in Firefly III. For 'asset' accounts, 'account_role' defaults to 'defaultAsset' (if 'ccAsset', also pass 'credit_card_type' and 'monthly_payment_date'). For 'liability' accounts, 'liability_type' ('loan', 'debt', or 'mortgage') is required.
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": {
"name": "<name>",
"type": "<type>"
},
"name": "create_account"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bic | No | BIC/SWIFT code if applicable. | |
| iban | No | IBAN if applicable. | |
| name | Yes | Account name (must be unique per account type). | |
| type | Yes | Type of account to create. | |
| notes | No | Optional Markdown notes for the account. | |
| active | No | Whether the account is active. | |
| interest | No | Interest rate percentage for liabilities (e.g. '4.25'). | |
| account_role | No | Role for 'asset' accounts only: 'defaultAsset', 'sharedAsset', 'savingAsset', 'ccAsset' (credit card), or 'cashWalletAsset'. Defaults to 'defaultAsset' when type='asset'. | |
| currency_code | No | ISO 4217 currency code (e.g. CNY, USD, EUR). Defaults to Firefly III's primary currency. | |
| account_number | No | Bank or card account number. | |
| liability_type | No | Required when type='liability': 'loan', 'debt', or 'mortgage'. | |
| interest_period | No | Interest period for liabilities. | |
| opening_balance | No | Initial opening balance as a decimal string (e.g. '1000.00'). Requires 'opening_balance_date' when set. | |
| virtual_balance | No | Virtual balance buffer as a decimal string (e.g. '0.00'). | |
| credit_card_type | No | Required when account_role='ccAsset'. Currently Firefly III supports 'monthlyFull'. | |
| include_net_worth | No | Whether to include this account in net worth calculations. | |
| liability_direction | No | Direction when type='liability': 'debit' (you owe money) or 'credit' (you are owed money). | |
| monthly_payment_date | No | Required when account_role='ccAsset' (YYYY-MM-DD). | |
| opening_balance_date | No | Date of the opening balance (YYYY-MM-DD). Required if 'opening_balance' is provided. |