SimpleFIN integration

Use BankSync as your SimpleFIN server. Paste one setup token into Actual Budget, Securo or any SimpleFIN app and it reads the banks you already connected.

BankSync · SimpleFIN access3 apps reading

Apps with access

  • Actual BudgetAll accounts · read at 6:02amActive
  • SecuroChase Checking, Fidelity Brokerage · read at 5:40amActive
  • Home AssistantChase Checking · read at 4:00amActive
  • Old laptop scriptRevoked Sep 30Revoked
Three apps, each with its own access and its own accounts. Rotate or revoke any one without touching the others.

One token, pasted once.

  1. 01

    Create access

    Settings › Developers › SimpleFIN. Pick the app and, if you like, only some accounts.

    AppActual Budget
    Account☑ Chase Checking
    Account☑ Amex Gold
    Account☐ Chase Savings
  2. 02

    Copy the setup token

    It is shown once, and expires in 7 days if it is never used.

    Setup token

    aHR0cHM6Ly9hcGkuYmFua3N5bmMuaW8vc2ltcGxlZmluL2NsYWltL3N0XzRmOWMy…
    ShownOnce
    UnusedExpires in 7 days
  3. 03

    Paste it into your app

    The app swaps it for its own credentials and syncs from then on.

    1Your app’s SimpleFIN screen
    2Paste the setup token
    3The app claims its own credentials

What your app reads.

Accounts
Each account in the access’s scope, with its name, bank and currency.
Balances
The current and available balance, and when the bank reported it.
Transactions
Posted date, signed amount and description, with pending ones flagged.
Holdings
Brokerage positions with quantity, value and cost basis, where the broker reports them.
Errors
A bank that needs reconnecting in BankSync is reported to the app, so it can show you.
Open Preview on any access to see the exact response the app gets.

The same data can also go to spreadsheets, workspaces, AI assistants and your own code.

SimpleFIN, in short.

Protocol
SimpleFIN. BankSync is the server; the app is the client.
Works with
Actual Budget, Securo, Sure, Home Assistant, Firefly III, beancount importers and your own scripts.
Scope
Every account, or only the ones you pick. Change it later without re-linking.
Control
Rotate issues a new token and stops the old credentials. Revoke ends access for good.
Access
Read-only, authorised on your bank’s own consent screen. BankSync never stores your bank login and cannot move money.
Setup
About 2 minutes. Included on every plan; no separate SimpleFIN subscription.
Status
Available today.

Questions, answered.

Do I need a SimpleFIN Bridge subscription?

No. BankSync is the SimpleFIN server, and SimpleFIN access is included on every BankSync plan, including Free. Paste the BankSync token where the app asks for a SimpleFIN token.

How do I connect an app to BankSync?

In BankSync, open Settings, Developers, SimpleFIN and create an access. Copy the setup token, then in the app: Your app’s SimpleFIN screen, Paste the setup token, The app claims its own credentials.

Can I limit which accounts an app sees?

Yes. Choose accounts when you create the access, and change the list later without re-linking. The app sees the new list on its next sync.

What if a setup token leaks?

Rotate the access. That issues a new setup token and immediately stops the credentials the app holds. Revoke ends the access for good. An unused token also expires after 7 days.

Your banks, in any SimpleFIN app.

BankSync is not affiliated with, endorsed by, or an official partner of SimpleFIN. SimpleFIN trademarks belong to their respective owners.