This document explains the setup required to re-establish a customer’s bank connection with Plaid. This is necessary when assets must be monitored or when account data needs to be refreshed on a frequent basis.
The ITEM_LOGIN_REQUIRED error typically occurs when the user’s bank connection is no longer valid and they must re-authenticate.
1. Why it happens
Banks periodically require users to log in again for security reasons. When this happens, Plaid (or your banking integration) can no longer access the user’s account data until the user re-authenticates.
Common causes:
-
The user changed their online banking username or password
-
The bank requires multi-factor authentication (MFA) again
-
The bank session expired due to time or inactivity
-
Additional security checks are required by the financial institution
2. What it means
The item (bank account connection) is no longer authorized.
The user must reconnect their account before you can:
-
Pull balances
-
Retrieve transactions
-
Fetch assets
-
Perform verification
3. How to resolve
Prompt the user to:
-
Re-authenticate / reconnect their bank