This document explains how to handle situations where a Plaid Item returns an ITEM_LOGIN_REQUIRED error in Salesforce.
This error typically occurs when a customer’s bank connection becomes invalid — for example, when their online banking credentials change, multi-factor authentication expires, or Plaid requires the user to reauthorize access.
To resolve this, Bank Connect provides an easy way to resend the verification request to the customer. The user simply clicks the Retry Verification button on the Bank Verification Record, which triggers a new email containing an updated Plaid reauthorization link.
Step-by-Step Instructions
Step 1: Identify Records with ITEM_LOGIN_REQUIRED Error
-
Navigate to the Bank Verification tab or the Bank Verification related list under the parent record (Source Object) in Salesforce, and locate the Bank Verification Record displaying the
ITEM_LOGIN_REQUIREDerror. -
Open the desired Bank Verification Record.
Step 2: Initiate ReSending Verification
-
On the Bank Verification Record page, locate & Click the ReSend Verification button.
-
A confirmation toast appear that the Record has been updated successfully.
Step 3: System Action — Resend Request
Once the ReSend Verification button is clicked:
-
Application triggers a backend process to regenerate a new verification link via the Plaid API. The new link will have &isUpdate=true appended at the end.
-
The system sends an email notification to the customer’s registered email address, containing the updated secure Plaid link.
-
The link allows the customer to reconnect and reauthorize their bank account credentials with Plaid.
Step 4: Monitor the Request Status
You can monitor the resend progress and result in the following ways:
-
Through the Specific Plaid Product Status Description field on the Bank Verification Record.
-
Once the customer completes the reauthorization using the link, the Specific Plaid Product Status Description automatically updates to reflect the successful connection.