This page provides common causes and troubleshooting suggestions for account connection errors. Error codes are returned as part of the accounts object when a connection error occurs:
accounts.connection.statusreturns erroraccounts.connection.error_codeshows the error codeaccounts.connection.error_messagewill provide additional information about the error
Some error messages shown to the user have placeholders for
[Link item name] and [Company name]. In such cases, for the screens samples below, they were replaced by Starbox and GoodLoans, respectively.Error example in an account object:
account_disabled
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account appears to be suspended or disabled.
Account object:
account_inaccessible
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s account is not currently accessible. Our team has been notified and is investigating.
Account object:
account_incomplete
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account is not yet active.
Account object:
auth_required
- API message
- User message
- Common causes
- Troubleshooting
This user’s connection has expired and requires re-authentication.
Account object:
expired_credentials
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user provided credentials which are out of date so a password reset is required.
Account object:
invalid_account_type
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user provided credentials for the wrong account type (e.g., a passenger account rather than a driver account, or an admin account rather than an employee account).
Account object:
invalid_auth
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s account connection was unsuccessful due to invalid credentials or due to failed or misconfigured multi-factor authentication (MFA).
Account object:
invalid_credentials
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user provided invalid credentials.
Account object:
invalid_login_method
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user tried to log in using an authentication method that is not supported by employer.
Account object:
invalid_mfa
- API message
- User message
- Common causes
- Troubleshooting
This user did not provide the correct multi-factor authentication response.
Account object:
login_attempts_exceeded
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user provided invalid credentials too many times, causing them to be temporarily unable to attempt further logins.
Account object:
mfa_attempts_exceeded
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user failed multi-factor authentication too many times, causing them to be unable to attempt further logins until multi-factor authentication method is reset.
Account object:
mfa_exhausted
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user failed multi-factor authentication too many times, requiring them to re-authenticate.
Account object:
mfa_not_configured
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user has not configured multi-factor authentication for their employment account, restricting access to the user’s employment data.
Account object:
mfa_timeout
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user did not complete multi-factor authentication.
Account object:
physical_mfa_unsupported
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account uses a physical multi-factor authentication method that Argyle does not currently support.
Account object:
service_unavailable
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
The platform this user is attempting to connect to is currently unavailable. See the Coverage page in Argyle Console for additional information.
Account object:
system_error
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
Argyle encountered a problem connecting to this account. Our team has been notified and is investigating.
Account object:
tos_required
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user has not accepted the Terms of Service presented by their payroll provider, preventing access to their employment account.
Account object:
trial_connections_exhausted
- API message
- User message
- Common causes
- Troubleshooting
This account could not be connected because you’ve reached your limit for free account connections in trial mode. Reach out to Argyle or visit Argyle Console to enable full access and connect unlimited accounts.
Account object:
trial_period_expired
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account is in a trial account, and is currently disabled because the trial period has expired.
Account object:
unsupported_auth_type
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user tried to log in using single sign-on (e.g., Google, Facebook), which Argyle does not currently support.
Account object:
unsupported_mfa_method
This error triggers the
accounts.failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account uses a multi-factor authentication method that Argyle does not currently support.