Skip to main content
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:
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:

{
  "id": "ac81e2bc-2157-4535-8ca4-fb1f068df1fc",
  ...
  "connection": {
    "status": "error",
    "error_code": "account_disabled",
    "error_message": "This user's employment account appears to be suspended or disabled.",
    "updated_at": "2019-11-29T08:37:42.112859"
  }
  ...
}

account_disabled

This error triggers the accounts.failed webhook.
This user’s employment account appears to be suspended or disabled.
The account_disabled account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "account_disabled",
    "error_message": "This user's employment account appears to be suspended or disabled.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

account_inaccessible

This error triggers the accounts.failed webhook.
This user’s account is not currently accessible. Our team has been notified and is investigating.
The account_inaccessible account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "account_inaccessible",
    "error_message": "This user's account is not currently accessible. Our team has been notified and is investigating.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

account_incomplete

This error triggers the accounts.failed webhook.
This user’s employment account is not yet active.
The account_incomplete account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "account_incomplete",
    "error_message": "This user's employment account is not yet active.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

auth_required

This user’s connection has expired and requires re-authentication.
The auth_required account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "auth_required",
    "error_message": "This user's connection has expired and requires re-authentication.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

expired_credentials

This error triggers the accounts.failed webhook.
This user provided credentials which are out of date so a password reset is required.
The expired_credentials account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "expired_credentials",
    "error_message": "This user provided credentials which are out of date (i.e., a password reset is required).",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

invalid_account_type

This error triggers the accounts.failed webhook.
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).
The invalid_account_type account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "invalid_account_type",
    "error_message": "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).",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

invalid_auth

This error triggers the accounts.failed webhook.
This user’s account connection was unsuccessful due to invalid credentials or due to failed or misconfigured multi-factor authentication (MFA).
The invalid_auth account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "invalid_auth",
    "error_message": "This user's account connection was unsuccessful due to invalid credentials or due to failed or misconfigured multi-factor authentication (MFA).",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

invalid_credentials

This error triggers the accounts.failed webhook.
This user provided invalid credentials.
The invalid_credentials account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "invalid_credentials",
    "error_message": "This user provided invalid credentials.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

invalid_login_method

This error triggers the accounts.failed webhook.
This user tried to log in using an authentication method that is not supported by employer.
The invalid_login_method account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "invalid_login_method",
    "error_message": "This user tried to log in using an authentication method that is not supported by employer.",
    "updated_at": "2022-11-27T04:12:42.154Z"
  }
  ...
}

invalid_mfa

This user did not provide the correct multi-factor authentication response.
The invalid_mfa account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "invalid_mfa",
    "error_message": "This user did not provide the correct multi-factor authentication response.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

login_attempts_exceeded

This error triggers the accounts.failed webhook.
This user provided invalid credentials too many times, causing them to be temporarily unable to attempt further logins.
The login_attempts_exceeded account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "login_attempts_exceeded",
    "error_message": "This user provided invalid credentials too many times, causing them to be temporarily unable to attempt further logins.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

mfa_attempts_exceeded

This error triggers the accounts.failed webhook.
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.
The mfa_attempts_exceeded account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "mfa_attempts_exceeded",
    "error_message": "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.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

mfa_exhausted

This error triggers the accounts.failed webhook.
This user failed multi-factor authentication too many times, requiring them to re-authenticate.
The mfa_exhausted account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "mfa_exhausted",
    "error_message": "This user failed multi-factor authentication too many times, requiring them to re-authenticate.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

mfa_not_configured

This error triggers the accounts.failed webhook.
This user has not configured multi-factor authentication for their employment account, restricting access to the user’s employment data.
The mfa_not_configured account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "mfa_not_configured",
    "error_message": "This user has not configured multi-factor authentication for their employment account, restricting access to the user's employment data.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

mfa_timeout

This error triggers the accounts.failed webhook.
This user did not complete multi-factor authentication.
The mfa_timeout account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "mfa_timeout",
    "error_message": "This user did not complete multi-factor authentication.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

physical_mfa_unsupported

This error triggers the accounts.failed webhook.
This user’s employment account uses a physical multi-factor authentication method that Argyle does not currently support.
The physical_mfa_unsupported account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "physical_mfa_unsupported",
    "error_message": "This user's employment account uses a physical multi-factor authentication method that Argyle does not currently support.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

service_unavailable

This error triggers the accounts.failed webhook.
The platform this user is attempting to connect to is currently unavailable. See the Coverage page in Argyle Console for additional information.
The service_unavailable account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "service_unavailable",
    "error_message": "The platform this user is attempting to connect to is currently unavailable. See the Coverage page in Argyle Console for additional information.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

system_error

This error triggers the accounts.failed webhook.
Argyle encountered a problem connecting to this account. Our team has been notified and is investigating.
The system_error account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "system_error",
    "error_message": "Argyle encountered a problem connecting to this account. Our team has been notified and is investigating.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

tos_required

This error triggers the accounts.failed webhook.
This user has not accepted the Terms of Service presented by their payroll provider, preventing access to their employment account.
The tos_required account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "tos_required",
    "error_message": "This user has not accepted the Terms of Service presented by their payroll provider, preventing access to their employment account.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

trial_connections_exhausted

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.
The trial_connections_exhausted account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "trial_connections_exhausted",
    "error_message": "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.",
    "updated_at": "2020-12-29T08:37:42.164Z"
  }
  ...
}

trial_period_expired

This error triggers the accounts.failed webhook.
This user’s employment account is in a trial account, and is currently disabled because the trial period has expired.
The trial_period_expired account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "trial_period_expired",
    "error_message": "This user's employment account is in a trial account, and is currently disabled because the trial period has expired.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

unsupported_auth_type

This error triggers the accounts.failed webhook.
This user tried to log in using single sign-on (e.g., Google, Facebook), which Argyle does not currently support.
The unsupported_auth_type account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "unsupported_auth_type",
    "error_message": "This user tried to log in using single sign-on (e.g., Google, Facebook), which Argyle does not currently support.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}

unsupported_mfa_method

This error triggers the accounts.failed webhook.
This user’s employment account uses a multi-factor authentication method that Argyle does not currently support.
The unsupported_mfa_method account connection error screen.

Account object:

{
  ...
  "connection": {
    "status": "error",
    "error_code": "unsupported_mfa_method",
    "error_message": "This user's employment account uses a multi-factor authentication method that Argyle does not currently support.",
    "updated_at": "2019-11-29T08:37:42.164Z"
  }
  ...
}