When an account stops updating
An account that has quietly stopped updating looks almost exactly like one that is working. The balance is still there, the transactions are still there, and the page looks healthy. What has changed is that nothing new is arriving — and SageFin says so, in a place that is easy to read the wrong way.
This page explains what it is actually telling you.
Open the account and read the Connection status card
Go to Accounts and click the account. On the right, under Summary, is a card headed Connection status with three rows. Each one carries a small circled i you can click for the same explanation you are reading here.
The three rows answer three different questions, and the most common mistake is to read one of them as the answer to another.
Last update
When data last arrived — not when SageFin last tried.
This is the row that misleads. A connection that broke a week ago still shows the day it last worked, and on its own that date looks perfectly fine. "Updated 6 days ago" does not mean the connection is healthy; it means six days ago was the last time anything got through.
Read it alongside Status. Neither row is the whole answer by itself.
Status
Whether the sign-in still works. Which is not the same as the data being current — a connection can say Institution Connected and still be days behind.
There are four states behind that row:
- Connected — the sign-in works. If an update is running right now, the card says so instead; that is the sync queue rather than the connection, and a working connection can sit idle for days while a broken one can still be queued.
- Needs reconnection — your bank wants you to sign in again. This is the common one, and the next section is about it.
- Error — the last attempt to fetch data failed. What is already here stays; new transactions and balances do not. It often clears on its own.
- Disconnected — the connection has been ended, by someone choosing Connection only when deleting it (see Deleting a connection) or by the person who linked it leaving the household. Everything already imported stays exactly where it is, and nothing new arrives. It cannot be reconnected; to sync that bank again, link it again. Apple Card, Cash, and Savings are the one exception: connect Apple Wallet again on the iPhone and the kept accounts pick up where they stopped (see Apple Card, Cash, and Savings).
Data provider
Who actually holds the connection to your bank.
SageFin does not sign in to your bank. A data provider — Plaid, or Finicity — does, and it is their screen you type your bank credentials into, not ours. We never see them. Plaid handles the connection and the data it collects under Plaid's End User Privacy Policy.
This row names that company. It is worth knowing, because it is the answer to "who has my bank login", and because the provider is what decides how a reconnection behaves.
Connecting a bank
When you pick a bank to connect, the first thing you see is Connect your bank: which company will connect it, what SageFin gets, and where to disconnect it later. Continue opens that company's window, where you sign in to your bank. Cancel closes it with nothing asked of anyone. Reconnecting a bank you have already linked skips this screen.
What SageFin gets depends on the company, and the screen says which:
- Plaid — your accounts, balances and transactions, and your investments and loans where your bank has them.
- Mastercard (shown as Finicity in SageFin) — your accounts, balances and transactions, and your investments where your bank has them. A loan arrives as an account with its balance, without its rate or payment details. After our screen, Mastercard shows its own consent step with its terms.
Either way, SageFin never sees your bank password and cannot move money.
How much history to bring in
On a bank Plaid connects, the same screen asks How much history to bring in: 3 months, 1 year or 2 years. 1 year is selected unless you choose otherwise. Three things are worth knowing before you pick:
- It can't be changed later without linking the bank again. Reconnecting keeps what the first link asked for.
- Your bank may send less. The choice is how far back SageFin asks; some banks keep less history than that, and you get what they have.
- More history means more transactions to review and categorize once they arrive.
A bank Mastercard connects always brings in a year, and has no choice to make.
Which company connects your bank
Some banks can be reached by both. Choosing the bank uses the one marked Default under its connection options — the ⋯ beside the bank in the list. That is Plaid wherever Plaid reaches the bank, and Finicity (Mastercard) where only it does. It is a fixed rule, not a judgment of which one works better for your bank. To use the other, open the connection options and click Connect beside it. If Plaid is reporting trouble with that bank, a note there says so; Mastercard publishes no such report, so Finicity never shows one.
A private household connects through Plaid only.
Why your bank asks you to sign in again
This is the single most confusing normal event in SageFin, so it is worth being clear that it is normal, and that it is not something going wrong.
When you connect a bank, you grant access — and that access expires. Sometimes it expires on a schedule your bank sets. Sometimes it ends because you changed your password, enabled two-factor authentication, or your bank asked you to re-confirm access on its own site. In every case the result is the same: the provider can no longer get in, and SageFin shows Needs reconnection.
Nothing already in SageFin is lost. Every transaction, balance and category you already have stays exactly where it is. Your budgets, rules and history are untouched. What stops is the flow of anything new.
Reconnecting
When a connection needs it, a Reconnect button appears on the Connection status card. Click it and your provider's window opens, usually asking only for the part that expired — often just a password, or a code your bank texts you. In the phone app, Reconnect is on the bank's card in Settings → Institutions.
You are not starting over. You are re-authorizing a connection SageFin already has, so:
- Your existing transactions stay put, and are not imported a second time.
- Your account keeps the name, category and settings you gave it.
- Nothing you have customized is reset.
If you want to update a connection that has not broken — a new password you have already changed, say — the same flow is in the ⋯ menu on that card as Update login settings.
When your bank tells us the date access ends
Some banks end access on a schedule and tell us about a week ahead. When that happens, Settings → Institutions shows Reconnect with the bank's name and the date, and you get a notification saying the same. Reconnecting any time before the date keeps the account updating with no gap. After you reconnect, the bank sets a new date, or none, and the note goes away.
Linking a bank you have already linked
If you link a bank again and choose accounts you have already linked yourself, SageFin does not add them a second time. You see Already linked with the bank's name, and Manage connection opens the connection you already have. Use it to share a different set of accounts, or, if that connection needs reconnection, to sign in again. Nothing new is created, so your bank is not linked twice and nothing appears twice.
This is only about your own sign-in. If someone else in your household links their own login at the same bank, both connections are kept, even when you share a joint account.
When reconnecting does not fix it
A few things that are worth trying, in the order they are worth trying them.
Refresh first. The ⋯ menu on the Connection status card has a Refresh, which asks for an update now rather than waiting for the next scheduled one. If the problem was a single failed attempt, this is the whole fix.
Give an Error state a little time. Error often means the bank was briefly unavailable rather than anything about your account. If it is still there the next day, treat it as a reconnection.
Check the bank's own site. Some banks require you to approve third-party access from inside online banking, and will keep refusing until you do. If your bank has a "connected apps" or "data sharing" page, look there.
Then write to us. The same ⋯ menu has Contact support, which opens an email with the subject already filled in. Tell us which institution it is and what the Status row says.
Deleting a connection
When you no longer want SageFin reading a bank at all — you closed the account, or you are moving it somewhere else — delete its connection. Go to Settings → Institutions, open the ⋯ menu on the bank, and choose Delete connection.
You are asked what to delete, and there are two choices:
- Connection only. The connection ends, and the accounts, their balances and their whole transaction history stay in SageFin. They stop syncing and updating, and keep counting in your net worth at their last balance. Use this when the history still matters to you — last year's spending, a budget, a report.
- Connection, accounts, and transactions. The connection ends, and every account that came from it is deleted with its balances, balance history, transactions and investment holdings. Those accounts leave your account list and your net worth.
Under the choice, What will happen lists what goes and what stays, with counts. Either way your categories, rules, budgets and goals stay, and a receipt you attached to one of the deleted transactions stays too, back among your unattached receipts.
To confirm, type the connection's name exactly as the box asks — capitals do not matter — and choose Delete permanently.
Both choices end SageFin's access at the bank for good. We tell the data provider to delete the connection on their side too, so they stop reading your bank on SageFin's behalf. That cannot be undone: to sync the bank again later you link it again, and its accounts come in as new ones. If you chose Connection only, the old accounts are still there beside the new ones.
Apple Card, Cash, and Savings work differently, because the access lives on your iPhone rather than with a provider. After Connection only they stay ended: refreshing them, Refresh all, asking the iPhone to sync from the web, and the iPhone's own background updates all stop, and nothing brings them back on its own. To sync them again, open SageFin on the iPhone and connect Apple Wallet again. The kept accounts are picked up where they stopped, so nothing comes in twice.
A connection that has already ended can still be deleted with its accounts and transactions, the same way, if you decide later that you do not want the history.
If your household uses private mode and is locked, SageFin cannot reach the connection's sign-in to end it at the provider, so deleting it waits until you unlock.
Accounts that cannot stop updating
Two kinds of account never show any of this, because there is no connection to break.
Manual accounts you keep up to date yourself. Nothing syncs them, so the balance changes only when you change it. That is why their Connection status card says there is no provider.
Apple Card, Cash, and Savings work differently again — they are read on your iPhone rather than by a provider, and have their own page.