Skip to main content

SimpleFIN Bank Sync

danger

This is an experimental feature. That means we’re still working on finishing it. There may be bugs, missing functionality or incomplete documentation, and we may decide to remove the feature in a future release. If you have any feedback, please open an issue or post a message in the Discord.

danger

All functionality described here may not be available in the latest stable release. Use the edge images for the latest implementation.

SimpleFIN Setup​

Generate Setup Token for Actual

  1. Create an account with SimpleFIN Bridge - https://beta-bridge.simplefin.org/ , by clicking "Get Started" and entering your email address.
  1. You will receive an email with the login link, after a few minutes. Click this link to log into your account dashboard.

  1. Accept the terms, on first login, and then you will be taken to "My Account".

  2. Link any banks that you wish.

    • You will need to add your accounts first, through "Financial Institutions" > New Connection
    • You will need to subscribe before your first can be added. Current rates are $1.50 / mo, or $15 / year.

  3. From the "My Accounts" page, under "Apps", click on "New Connection". Give your connection a name, and click "Create Setup Token" This is only for you to easily identify it in the SimpleFIN connections overview

  1. Save the generated Setup Token someplace safe (one-time use only).

  1. Back in Actual, click on “+ Add account” at the bottom of the sidebar.

  2. Click “Link bank account with SimpleFIN .”

  3. You will be asked to enter your SimpleFIN setup token. The keys from this value will be saved on the server, so you will only need to enter it once.

  1. Add the link to your accounts in actual (Existing or New)

    • For an existing account, click on that account, select the ... (kebab menu) in the top right, and choose Link Account
    • To create a new account with bank syncing click on the '+ Add account' link in the left menu at the bottom

  2. Select the Link bank account with SimpleFIN button

  3. A Link Accounts box will pop up. To link a SimpleFIN account to an Actual account, click the "Setup bank-sync" button in the same row.

    • The "Bank Account To Sync" column contains the names of the accounts found via SimpleFIN
    • The "Account in Actual" column contains the name of the Actual account it is linked to.
    • You can also click in the "Account in Actual" column, instead of clicking the "Setup bank-sync" button.

  4. Either select an existing Actual account to link to, or create a new one.

  5. When you've mapped all your accounts that you wish to, click the "Link Account" button.

Retrieve transactions​

Actual does not automatically perform syncs. You will need to manually request a sync to pull new transactions from SimpleFIN. To sync all accounts, click on "All Accounts" in the side menu, and then click "Sync", below the "All Accounts" header.
If you wish to only sync one account, view the desired account and click the sync button.

SimpleFIN Considerations​

  1. Currently, the sync pulls at most 90 days of data from each linked account. The amount of data SimpleFIN can get from each account may vary, so not all accounts may have 90 days of historical transactions that can be imported.

  2. SimpleFIN's data updates one time / day, roughly every 24 hours, for each linked account. The time of day that each bank updates in SimpleFIN may vary, even from day to day (based on the bank and upstream provider, MX).