Skip to main content

SimpleFIN Setup

note

Client Version 24.10.0 and Server Version 24.10.0 or higher are required for this feature.

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.

  2. You will receive an email with the login link, after a few minutes. Click this link to log into your account dashboard.

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

  4. 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.

  5. 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.

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

  7. Back in Actual, click on "+ Add account" at the bottom of the sidebar.

    The sidebar with the Add account button at the bottom highlighted

  8. Click Set up bank sync. This opens the Bank Sync page in Settings.

    The Add account dialog with the Set up bank sync button highlighted

  9. Under Providers, click Set up on the SimpleFIN card.

    The Providers section of the Bank Sync page with Set up on the SimpleFIN card highlighted

  10. 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.

    The Set-up SimpleFIN dialog with an empty Token field

  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

      The account menu with Link account highlighted

    • To create a new account with bank syncing click on the '+ Add account' link in the left menu at the bottom, then click Set up bank sync

      The sidebar with the Add account button at the bottom highlighted

  2. Click the Link bank account button on the SimpleFIN card.

    The Link account dialog with Link bank account on the SimpleFIN card highlighted

  3. A Link Accounts box will pop up. To link a SimpleFIN account to an Actual account, click the "Set up 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 "Set up bank sync" button.
    The Link Accounts dialog listing SimpleFIN accounts, with one Set up bank sync button highlighted

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

    The account picker open in the Account in Actual column, listing existing accounts and Create new account

  5. When you've mapped all your accounts that you wish to, click the "Link accounts" 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).

Resetting the Setup Token​

To reset your SimpleFIN setup token:

  1. Click "Add Account" in the sidebar.

  2. Next to "Link bank account with SimpleFIN", click the three-dot menu button.

  3. Click "Reset SimpleFIN credentials".

You will then need to obtain a new setup token from SimpleFIN and enter it into Actual.