Link web

Guide to troubleshooting Link errors on the web

Most errors returned by Link are an SDK-specific representation of an API error. For troubleshooting help, see the guidance for the specific API error.

In addition, there is one Link-specific error that does not correspond to an API error:

institution-poor-health-error

The user is trying to link to an institution with poor Plaid connectivity health.

Client-Side

Link user experience

Your user will see a warning pane before they enter their credentials, telling them that adding the account may fail and suggesting that they link a different account.

Common causes

The institution is experiencing a temporary disruption of connectivity to Plaid.

Troubleshooting steps

Have your user try connecting their account later.

If the problem persists, file a Plaid support ticket.

API error response
1
2
3
4
5
6
7
8
http code 400 
{
 "error_type": "",
 "error_code": "institution-poor-health-error",
 "error_message": null,
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}

oauth-error

Returned when the OAuth login session for a user either times out or errors out

Client-Side

Link user experience

Your user will be shown an error message indicating that their account was not successfully linked and will be prompted to retry their login attempt.

Common causes

Your user did not complete their OAuth login attempt within 10 minutes.
Plaid is experiencing internal system issues.

Troubleshooting steps

Have your user retry their login attempt and complete it within 10 minutes.

Have your user try connecting their account later.

API error response
1
2
3
4
5
6
7
8
http code 400 
{
 "error_type": "",
 "error_code": "oauth-error",
 "error_message": null,
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}