Skip to main content

​
Overview

Account connection errors occur when a user is actively attempting to connect a payroll account through Link.. To monitor for account connection errors:
  1. Subscribe to the accounts.failed webhook.
  2. Subscribe to the accounts.updated webhook and use the optional config parameter to receive an account object in the webhook’s delivery payload.
  3. When you receive the accounts.failed webhook or are encountering account connection issues, check the account object in payload of the accounts.updated webhook. If the status value of the connection object is error, proceed to the troubleshooting steps below.
    The accounts.updated webhook is always sent when the accounts.failed webhook is sent.

​
Account connection errors

​
account_disabled

An account may be disabled or taken offline for a variety of reasons, such as account inactivity.

​
account_inaccessible

The account unexpectedly cannot be accessed by Argyle. We have automatically been notified and will investigate.

​
account_incomplete

The accounts.failed webhook is sent when this error occurs.
The user has not finished setting up an account within their payroll system.

​
account_nonunique

The accounts.failed webhook is sent when this error occurs.
The personal details provided by the user during the Login help process of certain Items was a match for multiple account records stored by the payroll platform, resulting in an error.

​
account_not_found

The accounts.failed webhook is sent when this error occurs.
The personal details provided by the user during the Login help process of certain Items did not match an account record stored by the payroll platform.

​
all_employers_connected

The user has already connected all accounts associated with the recovery details (name, phone number, and/or email) they provided during the Login help process of certain Items.

​
auth_method_temporarily_unavailable

The accounts.failed webhook is sent when this error occurs.
The selected connection method is currently unavailable.

​
auth_required

An account has become disconnected and needs to be re-authenticated.

​
connection_unavailable

The accounts.failed webhook is sent when this error occurs.
A new connection attempt was unsuccessful because the account was unavailable.

​
credentials_managed_by_organization

The accounts.failed webhook is sent when this error occurs.
The credentials provided by the user during the Login help process of certain Items could not be adjusted in a self-service way because their credentials are centrally managed by their organization’s IT department for security reasons.

​
existing_account_found

The user attempted to connect an already-connected account during the Login help process of certain Items.

​
expired_credentials

The accounts.failed webhook is sent when this error occurs.
Some payroll platforms require users to periodically update their login credentials.

​
full_auth_required

This error is manually set by Argyle after investigating a previous error.

​
insufficient_account_data

The accounts.failed webhook is sent when this error occurs.
The user’s employment account has paystubs and tax documents available but lacks essential profile information (e.g., name, employment status) needed for a full verification.

​
invalid_account_type

The accounts.failed webhook is sent when this error occurs.
The user may have entered login credentials for the employer or payroll provider that are not related to their payroll credentials.

​
invalid_auth

The accounts.failed webhook is sent when this error occurs.
The user entered invalid login credentials to their payroll system, or was unable to successfully complete its multi-factor authentication (MFA) process.

​
invalid_credentials

The accounts.failed webhook is sent when this error occurs.
The user may have entered login credentials for the employer or payroll provider that are not related to their payroll credentials.

​
invalid_employer_identifier

The accounts.failed webhook is sent when this error occurs.
The user entered invalid login information related to the employer, such as an invalid company ID.

​
invalid_login_method

The accounts.failed webhook is sent when this error occurs.
This platform currently supports login methods for this payroll account that are different than the one attempted by the user when trying to connect.

​
invalid_login_url

The accounts.failed webhook is sent when this error occurs.
Some payroll platforms will successfully authenticate users when they use valid login credentials but throw an error because the wrong employer or payroll provider was selected.

​
invalid_mfa

This user did not provide the correct multi-factor authentication (MFA) response that was requested by the platform.

​
invalid_store_identifier

The accounts.failed webhook is sent when this error occurs.
The user entered invalid login information related to their store or club, such as an invalid store number.

​
login_attempts_exceeded

The accounts.failed webhook is sent when this error occurs.
The platform temporarily disabled login attempts for this payroll account due to entering invalid credentials too many times.

​
mfa_attempts_exceeded

The accounts.failed webhook is sent when this error occurs.
The platform permanently disabled login attempts for this payroll account due to entering an invalid MFA too many times. It only can be resolved by the user resetting MFA directly on the payroll system.

​
mfa_cancelled_by_the_user

The user exited the MFA screen during an account connection.

​
mfa_exhausted

The accounts.failed webhook is sent when this error occurs.
The platform requires a full re-authentication for this payroll account due to unsuccessfully completing MFA multiple times.

​
mfa_not_configured

The accounts.failed webhook is sent when this error occurs.
The payroll platform requires multi-factor authentication (MFA) to access payroll data.

​
mfa_timeout

The accounts.failed webhook is sent when this error occurs.
The user did not complete MFA within the given time period.

​
multi_driver_account

The accounts.failed webhook is sent when this error occurs.
This error occurs when a gig rideshare account is connected that has multiple drivers associated with it. Argyle only supports single-driver accounts due to data privacy.

​
ongoing_refresh_disabled

The accounts.updated webhook is sent when this error occurs.
Ongoing refresh was manually disabled via the API for this account.

​
passkey_limit_reached

The user has reached the maximum number of passkeys allowed on the platform.

​
physical_mfa_unsupported

The accounts.failed webhook is sent when this error occurs.
The user attempted to use a physical multi-factor authentication method that Argyle does not support.

​
platform_temporarily_unavailable

The accounts.failed webhook is sent when this error occurs.
The account’s underlying payroll system is experiencing connection issues. New connections are temporarily unavailable.

​
platform_unavailable

The accounts.failed webhook is sent when this error occurs.
The underlying payroll system limits connections to business hours.

​
service_unavailable

The accounts.failed webhook is sent when this error occurs.
The payroll system may be offline due to planned maintenance or is experiencing service interruptions.

​
session_limit_reached

The accounts.failed webhook is sent when this error occurs.
Some platforms impose limits on the number of active sessions. If a user has reached this limit by being logged into the platform on another device or window, Argyle will not initiate a new connection to avoid disconnecting the user from their other active sessions.

​
system_error

The accounts.failed webhook is sent when this error occurs.
An unexpected error occurred, such as an invalid session or unavailable service.

​
temporary_credentials

The accounts.failed webhook is sent when this error occurs.
The user attempted to connect an account with a temporary password.

​
tos_required

The accounts.failed webhook is sent when this error occurs.
The payroll system requires the user to accept the Terms of Service to allow access to the payroll account or its data.

​
trial_connections_exhausted

The accounts.failed webhook is sent when this error occurs.
This account could not be connected because you’ve reached your limit for free account connections in Argyle’s trial mode.

​
trial_period_expired

The accounts.failed webhook is sent when this error occurs.
This user’s payroll account was a trial account on the payroll system’s platform, and is currently disabled because the trial period has expired.

​
unrecognized_employer_email

The accounts.failed webhook is sent when this error occurs.
The user entered an email address during login with a domain address that is not associated with the selected employer.

​
unsupported_auth_type

The accounts.failed webhook is sent when this error occurs.
Argyle does not support the user’s attempted single sign-on (SSO) method for this particular payroll system.

​
unsupported_business_account

The accounts.failed webhook is sent when this error occurs.
The user submitted business account credentials instead of their personal credentials needed to access their payroll account.

​
unsupported_language

The accounts.failed webhook is sent when this error occurs.
The user’s payroll system contains data or documents that are in a language not currently supported by Argyle.

​
unsupported_mfa_method

The accounts.failed webhook is sent when this error occurs.
The user’s payroll system uses an MFA method that Argyle does not currently support.

​
user_action_timeout

The accounts.failed webhook is sent when this error occurs.
The user failed to select their current employer or create a new password within the given time period required to connect an account during the Login help process for certain Items.