> ## Documentation Index
> Fetch the complete documentation index at: https://docs.redbark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Firefly III

> Sync Australian bank accounts to a self-hosted Firefly III instance

The [Firefly III data importer](https://docs.firefly-iii.org) 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.

<Info>
  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.
</Info>

## Prerequisites

* A running [Firefly III](https://firefly-iii.org) instance
* The [Firefly III data importer](https://docs.firefly-iii.org/references/data-importer/) with SimpleFIN support
* A Redbark account with connected bank accounts
* A Redbark **Developer** or **Professional** plan (trials included)

## Setup

<Steps>
  <Step title="Generate a SimpleFIN setup token">
    Log into [Redbark](https://app.redbark.com), 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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Set a start date">
    Set a start date before the first import.

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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](/api-reference/simplefin).