Skip to main content
Link errors: common causes and troubleshooting.

Overview

When a user encounters an error in Link, they are shown an error screen that displays suggestions for resolving the particular issue. For easier troubleshooting, we recommend you include the onError callback in your Link initialization. The onError callback returns:
LinkError (
    "userId": String,           // ID of the user
    "errorType": String (enum), // Error name
    "errorMessage": String,     // User message
    "errorDetails": String      // Error details
)

callback_undefined

This page does not exist. Reach out to [Company name] for help.
callback_undefined Link error

duplicate_account

This User ID is already associated with a connected account. Please try a different User ID to connect another account.
duplicate_account Link error

expired_user_token

The service is experiencing connection problems. Please try again later.
expired_user_token Link error

generic

The service is experiencing connection problems. Please try again later.
generic Link error

invalid_account_id

The page does not exist. Reach out the [Company] for help.
invalid_account_id Link error

invalid_items

This page does not exist. Reach out to [Company name] for help.
invalid_items Link error

invalid_user_token

The service is experiencing connection problems. Please try again later.
invalid_user_token Link error