SimpleFIN Bridge
The SimpleFIN Bridge lets you expose your Lunch Flow bank accounts via the SimpleFIN protocol. Any app that supports SimpleFIN can sync your accounts and transactions from Lunch Flow without any modification — just paste a setup token and go.
This is ideal if you use an app like Actual Budget that supports SimpleFIN but not Lunch Flow natively, giving you access to Lunch Flow's bank coverage (including European banks via GoCardless) through a familiar interface.
Prerequisites
- At least one bank account connected in Lunch Flow
- An app that supports SimpleFIN (e.g. Actual Budget)
Setup
Create a SimpleFIN Bridge destination
In Lunch Flow, go to Destinations and click Add Destination. Select SimpleFIN Bridge and give it a name.
Select your accounts
On the destination detail page, toggle on the accounts you want to expose through the bridge.
Generate a setup token
Click Generate Setup Token. Copy the token — it's valid for 7 days and can only be used once.
Paste into your app
In your SimpleFIN-compatible app, go to the bank sync settings and select SimpleFIN. Paste the setup token when prompted.
For Actual Budget: go to Settings > Bank Sync > Set up SimpleFIN and paste the token.
Sync your accounts
Link the accounts that appear and start syncing. Your app will pull transactions and balances from Lunch Flow whenever you trigger a sync.
How it works
The SimpleFIN Bridge implements the SimpleFIN protocol:
- Setup token — a base64-encoded URL pointing to Lunch Flow's claim endpoint
- Claim — your app exchanges the token for a permanent access URL with embedded credentials
- Sync — your app fetches accounts and transactions using HTTP Basic Auth
Lunch Flow acts as the SimpleFIN bridge server. Your app doesn't know or care that the data comes from Lunch Flow — it just sees a standard SimpleFIN API.
FAQ
How is this guide?