Skip to main content
The Firefly III data importer supports SimpleFIN. Redbark implements SimpleFIN with Australian Open Banking data, so the importer can pull your accounts, balances and transactions with a single setup token and no bridge script to maintain.
Firefly III imports through its separate data importer (firefly-iii/data-importer), not the main Firefly application. If you don’t already run the importer, add it to your stack first.

Prerequisites

  • A running Firefly III instance
  • The Firefly III data importer with SimpleFIN support
  • A Redbark account with connected bank accounts
  • A Redbark Developer or Professional plan (trials included)

Setup

1

Generate a SimpleFIN setup token

Log into Redbark, go to Settings > SimpleFIN, and generate a setup token. Name it after your Firefly instance.The token is shown once, can be claimed once, and expires in 7 days if unused.
2

Start a SimpleFIN import

In the data importer, choose the SimpleFIN import flow and paste the Redbark setup token when it asks for one. The importer claims the token and receives its own private, read-only credentials.
3

Set a start date

Set a start date before the first import.
Without a start date the importer walks history from 1970 in 44-day chunks, which makes the first import extremely slow. A few months back is usually enough.
4

Map accounts and import

Map each Redbark account to a Firefly III asset account, then run the import. Later runs pick up new transactions from where the last one finished.

How it behaves

  • Balances and transactions are proxied live from your bank at the moment the importer asks. Redbark keeps no copy.
  • Every transaction carries a stable bank-issued ID, so repeat imports reconcile instead of duplicating.
  • Only banking accounts are served over SimpleFIN. Brokerage accounts connected to Redbark are not exposed.
  • Rate limiting is sized for the importer’s chunked backfill: 300 requests per minute per connected app. Windows older than the history floor skip the transaction fetch and serve cached balances.
  • Revoking the token from Settings > SimpleFIN cuts the importer’s access immediately without touching your bank consent or any other connected app.
Protocol details, limits and query parameters are in the SimpleFIN reference.