Documentation Index
Fetch the complete documentation index at: https://docs.argyle.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Account connection errors occur when a user is actively attempting to connect a payroll account through Link..
To monitor for account connection errors:
-
Subscribe to the
accounts.failed webhook.
-
Subscribe to the
accounts.updated webhook and use the optional config parameter to receive an account object in the webhook’s delivery payload.
-
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
Common causes
User message
API message
Troubleshooting
An account may be disabled or taken offline for a variety of reasons, such as account inactivity.
Your employment account appears to be disabled. Please make sure your account is active in the [Company name] system and try again.
This user’s employment account appears to be suspended or disabled.
Advise the user to contact their payroll provider for further clarification.
account_inaccessible
Common causes
User message
API message
Troubleshooting
The account unexpectedly cannot be accessed by Argyle. We have automatically been notified and will investigate.
Your employment account could not be connected. Please make sure your account is active, you’ve accepted [Company name]‘s’ terms of service, and your onboarding is complete.
This user’s account is not currently accessible. Our team has been notified and is investigating.
No action needed while we investigate. Reach out to our customer support team for more information.
account_incomplete
Common causes
User message
API message
Troubleshooting
The user has not finished setting up an account within their payroll system.
Your employment account is not active yet. Please log in to [Company name] and finish the onboarding process in order to access your account.
This user’s employment account is not yet active.
Advise the user to complete the onboarding or account set-up process in their payroll system, or contact their payroll provider for additional help.
account_nonunique
Common causes
User message
API message
Troubleshooting
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.
The information you provided is not unique, and multiple matching records were found. For assistance, please contact your employer’s HR or Payroll department.
The information provided by the user is not unique. Multiple records match their details. They should contact their employer’s HR or Payroll department for assistance.
Advise the user to double-check what personal details they currently or originally used to log in directly to the payroll platform, or contact their employer’s HR or Payroll department for assistance.
account_not_found
Common causes
User message
API message
Troubleshooting
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.
No matching record found. Please review your entries and try again.
The user did not provide correct personal details to verify their identity and locate their record.
Advise the user to double-check what personal details they currently or originally used to log in directly to the payroll platform.
all_employers_connected
Common causes
User message
API message
Troubleshooting
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.
All your [Company name] employers are connected. Check your details or select another employer or payroll provider.
The user attempted to connect an account that is already connected.
Advise the user to double-check what personal details they currently or originally used to log in directly to the payroll platform for the intended employer.
auth_method_temporarily_unavailable
Common causes
User message
API message
Troubleshooting
The selected connection method is currently unavailable.
We can’t complete the connection using this method right now. Try logging in with an alternative method.
The authentication method the user selected is temporarily unavailable.
Users will be directed to an alternative login option to establish a connection. If they are still unable to connect, advise them to wait and retry later to see if the original method has become available.
auth_required
Common causes
User message
API message
Troubleshooting
An account has become disconnected and needs to be re-authenticated. Please reconnect your [Company name] account to continue sharing data with [Your company name].
This user’s connection has expired and requires re-authentication.
Follow the steps in our Reconnecting Accounts Guide to allow the user to return to Link and reconnect their disconnected account. connection_unavailable
Common causes
User message
API message
Troubleshooting
A new connection attempt was unsuccessful because the account was unavailable.
This service is currently experiencing connectivity issues. Please try again or use another connection method.
The platform this user is attempting to connect to is currently unavailable. See the Coverage page in Argyle Console for additional information.
Find which Item was unavailable in Link by filtering the Connections section of Console by Attempted status. Search for and select the Item within the Coverage section of Console to read more about issues the underlying platform is experiencing. The API’s /items endpoint also provides information on when issues occur, and when they are expected to be resolved. credentials_managed_by_organization
Common causes
User message
API message
Troubleshooting
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.
Your user ID and password are managed by your organization. Please contact your administrator for help.
The user’s credentials are managed by their organization.
Advise the user to reach out to their organization’s IT department for help recovering their user ID or resetting their password.
existing_account_found
Common causes
User message
API message
Troubleshooting
The user attempted to connect an already-connected account during the Login help process of certain Items.
This account is already connected. Check your details or select another employer or payroll provider.
The user attempted to connect an account that is already connected.
Advise the user to double-check what personal details they currently or originally used to log in directly to the payroll platform for the intended employer.
expired_credentials
Common causes
User message
API message
Troubleshooting
Some payroll platforms require users to periodically update their login credentials.
Your login credentials have expired. Please reset the password for your [Company name] account and try again.
This user provided credentials which are out of date so a password reset is required.
Follow the steps in the expired credentials section of our Reconnecting Accounts Guide, or ask the user to visit their payroll system directly to change their login credentials. full_auth_required
Common causes
User message
API message
Troubleshooting
This error is manually set by Argyle after investigating a previous error.
We were unable to connect your [Company name] account. Please try to connect again.
This user’s connection has expired and requires re-authentication.
Follow the steps in our Reconnecting Accounts Guide to allow the user to return to Link and reconnect their disconnected account. The user will need to re-enter their login credentials. insufficient_account_data
Common causes
User message
API message
Troubleshooting
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.
Your employment account doesn’t have the necessary data to proceed. Please try connecting a different account.
This user’s employment account does not contain sufficient data to proceed. The user should be prompted to connect an alternative account.
If the account is missing critical data that you need, prompt the user to connect a different employment account that may have the necessary information.
invalid_account_type
Common causes
User message
API message
Troubleshooting
The user may have entered login credentials for the employer or payroll provider that are not related to their payroll credentials.
This is an unsupported account type (e.g. a rider account instead of a driver account). Please log in with credentials for your employment-related account with [Company name].
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).
Confirm that the user entered their correct payroll login credentials. If so, ask them if they are able to log in to their payroll system directly.
invalid_auth
Common causes
User message
API message
Troubleshooting
The user entered invalid login credentials to their payroll system, or was unable to successfully complete its multi-factor authentication (MFA) process.
Your connection was unsuccessful due to invalid credentials or due to failed or misconfigured multi-factor authentication (MFA).
This user’s account connection was unsuccessful due to invalid credentials or due to failed or misconfigured multi-factor authentication (MFA).
Check if the user was presented with or had trouble completing an MFA process. If not, confirm that the user entered the correct login credentials by asking them or having them attempt to directly log in to the payroll system.
invalid_credentials
Common causes
User message
API message
Troubleshooting
The user may have entered login credentials for the employer or payroll provider that are not related to their payroll credentials.
Invalid credentials. Try again or get help logging in.
This user provided invalid credentials.
Confirm that the user entered their correct payroll login credentials. Ask the user if they are able to log in to their payroll system directly. If so, advise the user to change their password and try again.
invalid_employer_identifier
Common causes
User message
API message
Troubleshooting
The user entered invalid login information related to the employer, such as an invalid company ID.
Invalid Company details. Try again or get help logging in.
This user provided invalid company/employer identifier.
Confirm that the user entered their correct payroll login credentials and employer-related identifier(s).
invalid_login_method
Common causes
User message
API message
Troubleshooting
This platform currently supports login methods for this payroll account that are different than the one attempted by the user when trying to connect.
Your Company ID cannot be used with selected login method. Please use a different login method.
This user tried to log in using an authentication method that is not supported by employer.
Advise the user to select a different available login method. Specific employers sometimes restrict logins to a default method or SSO, despite the payroll platform supporting additional login methods.
invalid_login_url
Common causes
User message
API message
Troubleshooting
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.
You have successfully logged in, but no corresponding user could be found. Search for your employer or payroll provider.
The user provided the correct login credentials, but no corresponding account was found. The user should try again by selecting the appropriate Link item for their employer or payroll provider.
Advise the user to connect their account using a Link item that represents their specific employer or payroll provider.
invalid_mfa
Common causes
User message
API message
Troubleshooting
This user did not provide the correct multi-factor authentication (MFA) response that was requested by the platform.
Multi-factor authentication was not successful. Please try again.
This user did not provide the correct multi-factor authentication response.
Confirm the user received the MFA request. If so, see if the user encountered problems completing the request. See if the issue persists when the user directly logs in to their payroll account.
invalid_store_identifier
Common causes
User message
API message
Troubleshooting
The user entered invalid login information related to their store or club, such as an invalid store number.
Invalid Store/Club Number. Try again or get help logging in.
This user provided invalid store/club number.
Confirm that the user entered their correct payroll login credentials and store-related identifier(s).
known_employer_redirect
Common causes
User message
API message
Troubleshooting
The user was successfully redirected to their employer’s login screen after providing information that identified their employer.
No error message. User was redirected to Link’s login screen.
This user was redirected to a specific employer login after starting with the generic flow because a known employer was identified.
Advise the user to enter their credentials to complete the login process.
login_attempts_exceeded
Common causes
User message
API message
Troubleshooting
The platform temporarily disabled login attempts for this payroll account due to entering invalid credentials too many times.
Unavailable because of too many failed login attempts. Please try again in a few hours.
This user provided invalid credentials too many times, causing them to be temporarily unable to attempt further logins.
Advise the user to wait a few hours before attempting to connect their account again.
login_cancelled_by_the_user
Common causes
User message
API message
Troubleshooting
The user exited Link’s login screen before submitting credentials during a multi-step login flow used by certain Items.
No error message. User moved to a different page or exited Link.
The user canceled the login process during the credential entry step.
Advise the user to re-attempt the connection and complete the login process.
mfa_attempts_exceeded
Common causes
User message
API message
Troubleshooting
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.
Unavailable because of too many unsuccessful multi-factor authentication attempts. Please log in to [Company name] and reset your multi-factor authentication method.
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.
Advise the user to reset their MFA method on the platform’s website or app, and then re-attempt account connection.
mfa_cancelled_by_the_user
Common causes
User message
API message
Troubleshooting
The user exited the MFA screen during an account connection.
No error message. Users return to the login screen after exiting the MFA screen.
This user canceled the Multi-Factor Authentication (MFA) step.
The user may have exited the MFA process after entering an incorrect phone number or other typo error. Have the user retry the connection and ensure they are providing the correct MFA information for the account.
mfa_exhausted
Common causes
User message
API message
Troubleshooting
The platform requires a full re-authentication for this payroll account due to unsuccessfully completing MFA multiple times.
Unavailable because of too many failed multi-factor authentication attempts. [Company name] requires you to log in again.
This user failed multi-factor authentication too many times, requiring them to re-authenticate.
Typically the user needs to go back and re-enter their login credentials to enable additional attempts. Then advise the user to re-attempt account connection.
Common causes
User message
API message
Troubleshooting
The payroll platform requires multi-factor authentication (MFA) to access payroll data.
Please log in to [Company name] and configure multi-factor authentication to continue sharing your data with [Your company name].
This user has not configured multi-factor authentication for their employment account, restricting access to the user’s employment data.
Advise the user to configure an MFA method on their payroll system and then re-attempt account connection.
mfa_timeout
Common causes
User message
API message
Troubleshooting
The user did not complete MFA within the given time period.
Your multi-factor authentication (MFA) session has expired. Please log in again to complete the MFA process.
This user did not complete multi-factor authentication.
Confirm the user received the MFA request. Have the user check if their MFA device information is correct, and if their device is set up to receive the selected MFA message from the payroll platform (e.g. SMS). Lastly, check if the user can directly log in within the payroll platform.
multi_driver_account
Common causes
User message
API message
Troubleshooting
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.
This account type is not supported because it contains information for multiple drivers.
The user attempted to connect an unsupported account type - the account contains multiple driver information.
The user will need to connect a different account such as a personal account that is associated with only one driver.
ongoing_refresh_disabled
Common causes
User message
API message
Troubleshooting
Ongoing refresh was manually disabled via the API for this account. Please reconnect your [Company name] account to continue sharing data with [Your company name].
Ongoing refresh was disabled for this account. To resume ongoing refresh the user needs to reconnect the account.
After ongoing refresh is disabled, the user will experience this account connection error if they return to the account in Link. Ongoing refresh will be re-enabled if the user selects Reconnect.
passkey_limit_reached
Common causes
User message
API message
Troubleshooting
The user has reached the maximum number of passkeys allowed on the platform.
Your payroll account has the maximum number of passkeys. Remove a passkey you don’t use in your account settings, then try again.
The user’s payroll account has reached the maximum number of registered passkeys. The user must remove at least one passkey and try again.
Advise the user to remove a passkey then retry their account connection.
physical_mfa_unsupported
Common causes
User message
API message
Troubleshooting
The user attempted to use a physical multi-factor authentication method that Argyle does not support.
We were not able to connect your employment account. Please log in to [Company name] to update your multi-factor authentication method and try again.
This user’s employment account uses a physical multi-factor authentication method that Argyle does not currently support.
Ask the user to update their settings or switch to an alternative multi-factor authentication method and try again.
Common causes
User message
API message
Troubleshooting
The account’s underlying payroll system is experiencing connection issues. New connections are temporarily unavailable.
We’re having trouble connecting right now. Please check back in a few hours and try again.
The platform this user is attempting to connect to is temporarily unavailable.
Advise the user to wait a few hours and then re-attempt to connect their account.When the platform once again becomes available, the account’s error status will be switched from this error to the full_auth_required error. You can use this to automate when to return the user to Link to re-attempt their account connection. Common causes
User message
API message
Troubleshooting
The underlying payroll system limits connections to business hours.
[Company name] system is currently unavailable. Please try again during the service hours (Eastern time): Monday - Friday 5AM - 1AM, Saturday 5AM - 11PM, Sunday 8AM - 11PM.
The platform this user is attempting to connect to is currently unavailable. See the Coverage page in Console for additional information. Advise the user to re-attempt the connection when normal service resumes: (Eastern time): Monday - Friday 5AM - 1AM, Saturday 5AM - 11PM, Sunday 8AM - 11PM.
service_unavailable
Common causes
User message
API message
Troubleshooting
The payroll system may be offline due to planned maintenance or is experiencing service interruptions.
[Company name] system is currently unavailable. Please try again later.
The platform this user is attempting to connect to is currently unavailable. See the Coverage page in Argyle Console for additional information.
Use Console’s Coverage page or the Items API endpoint to view the Item’s health status and any additional details. If there are underlying issues, advise the user that service will resume shortly and to await further updates. If there are no known issues, ask the user to re-attempt the account connection. session_limit_reached
Common causes
User message
API message
Troubleshooting
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.
[Company name] limits the number of active connections to your account. To continue, please sign out of the [Company name] app.
This user’s account connection was unsuccessful due to the platform’s limit on active sessions.
Advise the user to sign out from any other devices or sessions where the platform is currently active.
system_error
Common causes
User message
API message
Troubleshooting
An unexpected error occurred, such as an invalid session or unavailable service.
We’ve encountered an unexpected error. Please try again later.
Argyle encountered a problem connecting to this account. Our team has been notified and is investigating.
No action needed. We have automatically been notified and will investigate. Reach out to our customer support team for more information.
temporary_credentials
Common causes
User message
API message
Troubleshooting
The user attempted to connect an account with a temporary password.
You’re using a temporary password. Please log in to [Company name] directly to set a permanent password, then return here to connect.
The user provided a temporary password. A permanent password must be set via the payroll provider’s website before continuing.
Advise the user to set a permanent password on their platform using the temporary password. Have the user try again once they are able to log in directly to the platform with their permanent password.
tos_required
Common causes
User message
API message
Troubleshooting
The payroll system requires the user to accept the Terms of Service to allow access to the payroll account or its data.
Please log in to [Company name] and make sure you’ve accepted the latest terms and conditions to continue sharing your data with [Your company name]. Click try again to reactivate your connection.
This user has not accepted the Terms of Service presented by their payroll provider, preventing access to their employment account.
Advise the user to log in directly to their payroll system and accept the Terms of Service, or reach out to their payroll provider for further clarification.
trial_connections_exhausted
Common causes
User message
API message
Troubleshooting
This account could not be connected because you’ve reached your limit for free account connections in Argyle’s trial mode.
Connection is currently unavailable. Please reach out to [Company name] for help.
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.
Contact us or visit Console to enable full access and connect unlimited accounts.
trial_period_expired
Common causes
User message
API message
Troubleshooting
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.
Your employment account is a trial account that has expired. Please log in to [Company name] system to reactivate your account and try again.
This user’s employment account is in a trial account, and is currently disabled because the trial period has expired.
Advise the user to contact their payroll provider for further clarification.
unrecognized_employer_email
Common causes
User message
API message
Troubleshooting
The user entered an email address during login with a domain address that is not associated with the selected employer.
The email provided does not match the employer. Please use your work email associated with [Company name] to log in.
This user provided email that does not match the employer.
Confirm that the user entered an email address during login with a domain address associated with their selected employer. For example, Company A may require emails always ending in @company-a.com.Often the user may have entered their personal email by mistake.
unsupported_auth_type
Common causes
User message
API message
Troubleshooting
Argyle does not support the user’s attempted single sign-on (SSO) method for this particular payroll system.
Single sign-on (SSO) login method is not supported. Please use a different login method.
This user tried to log in using single sign-on (e.g., Google, Facebook), which Argyle does not currently support.
Advise the user to re-attempt the connection using text login credentials such as a username/password combination.
unsupported_business_account
Common causes
User message
API message
Troubleshooting
The user submitted business account credentials instead of their personal credentials needed to access their payroll account.
Please log in using a personal account, or search for another payroll provider if you have other sources of income.
This user provided credentials for their business account.
Confirm that the user submitted their personal account credentials, and not their business account credentials.
unsupported_language
Common causes
User message
API message
Troubleshooting
The user’s payroll system contains data or documents that are in a language not currently supported by Argyle.
Payroll provider’s language is not currently supported.
The user’s account connection failed because the payroll provider’s language is currently unsupported.
Advise the user to switch their payroll system’s language settings to English and then re-attempt account connection.
unsupported_mfa_method
Common causes
User message
API message
Troubleshooting
The user’s payroll system uses an MFA method that Argyle does not currently support.
We were not able to connect your employment account. Please log in to [Company name] to update your multi-factor authentication method and try again.
The user’s account connection failed because the payroll provider’s language is currently unsupported.
Advise the user to change or temporarily disable the MFA method.
user_action_timeout
Common causes
User message
API message
Troubleshooting
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.
Your session has expired. Please try again.
This user did not complete employer selection or new password creation.
Advise the user to exit the connection process and start over.
