Account Connection Errors

Errors that occur during the account connection flow.

Overview

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.

The tag Webhook indicates if the error triggers the related webhook.

Related webhook

account_disabledWebhook

API error_message

This user's employment account appears to be suspended or disabled.

Message to the user

Common causes

Troubleshooting steps

account_inaccessibleWebhook

API error_message

This user's account is not currently accessible. Our team has been notified and is investigating.

Message to the user

Common causes

Troubleshooting steps

account_incompleteWebhook

API error_message

This user's employment account is not yet active.

Message to the users

Common causes

Troubleshooting steps

auth_required

API error_message

This user's connection has expired and requires re-authentication.

Message to the users

Common causes

Troubleshooting steps

expired_credentialsWebhook

API error_message

This user provided credentials which are out of date (i.e., a password reset is required).

Message to the users

Common causes

Troubleshooting steps

invalid_account_typeWebhook

API 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).

Message to the users

Common causes

Troubleshooting steps

invalid_authWebhook

API error_message

This user's account login was unsuccessful, either due to invalid credentials or unsuccessful multi-factor authentication.

Message to the users

Common causes

Troubleshooting steps

invalid_credentialsWebhook

API error_message

This user provided invalid credentials.

Message to the users

Common causes

Troubleshooting steps

invalid_mfaWebhook

API error_message

This user did not provide the correct multi-factor authentication response.

Message to the users

Common causes

Troubleshooting steps

login_attempts_exceededWebhook

API error_message

This user provided invalid credentials too many times, causing them to be temporarily unable to attempt further logins.

Message to the users

Common causes

Troubleshooting steps

mfa_attempts_exceededWebhook

API 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.

Message to the users

Common causes

Troubleshooting steps

mfa_exhaustedWebhook

API error_message

This user failed multi-factor authentication too many times, requiring them to re-authenticate.

Message to the users

Common causes

Troubleshooting steps

mfa_not_configuredWebhook

API error_message

This user has not configured multi-factor authentication for their employment account, restricting access to the user's employment data.

Message to the users

Common causes

Troubleshooting steps

mfa_timeoutWebhook

API error_message

This user did not complete multi-factor authentication.

Message to the users

Common causes

Troubleshooting steps

service_unavailableWebhook

API error_message

The platform this user is attempting to connect to is currently unavailable. See the Coverage page in Argyle Console for additional information.

Message to the users

Common causes

Troubleshooting steps

system_errorWebhook

API error_message

Argyle encountered a problem connecting to this account. Our team has been notified and is investigating.

Message to the users

Common causes

Troubleshooting steps

tos_requiredWebhook

API error_message

This user has not accepted the Terms of Service presented by their payroll provider, preventing access to their employment account.

Message to the users

Common causes

Troubleshooting steps

trial_period_expiredWebhook

API error_message

This user's employment account is in a trial account, and is currently disabled because the trial period has expired.

Message to the users

Common causes

Troubleshooting steps

unsupported_auth_typeWebhook

API error_message

This user tried to log in using single sign-on (e.g., Google, Facebook), which Argyle does not currently support.

Message to the users

Common causes

Troubleshooting steps

unsupported_mfa_methodWebhook

API error_message

This user's employment account uses a multi-factor authentication method that Argyle does not currently support.

Message to the users

Common causes

Troubleshooting steps