Skip to main content
A connection can require user action after the original session. Reuse the existing user and active verification whenever the workflow allows it. Payroll account IDs, account errors, and the Link reconnection screens described below apply to payroll connections. For banking, create another session for the active verification and restart the connection flow. See Banking Verifications.

​
Choose the return path

​
Active verification

If a payroll or banking verification remains active in pending or user_session_started, create a new session for the same verification with POST /v2/sessions. Session links expire after one hour. An expired session does not require another user or verification. For an invite session, create a new invite for the existing user and active verifications when the original invite has expired or been revoked. See Recovery and Errors.

​
New verification or refreshed report

A completed or cancelled verification is terminal.
  • Create a new verification when the user needs to complete another verification order.
  • Use Re-verification when an existing connection or uploaded documents can support an updated report.
For a direct-data implementation:
  1. Create a new user token for the existing user.
  2. Initialize Link with that user token.
  3. Include accountId to open the existing account directly.
Retrieve account IDs from the Accounts API or copy the ID from the account details in Console.

​
Console invitations and Shareable URLs

For users originally sent through Console, use Connections to resend or copy their existing link when that option is available. For Shareable URL implementations, follow the reconnecting users workflow. Avoid creating another user only to return the same person to Link. A duplicate user separates the person’s existing accounts and data from the new record.

​
Why accounts disconnect

Some connected payroll systems require users to reauthenticate periodically or update credentials. Existing data remains available after a disconnection, but ongoing refresh pauses until the user reconnects the account. The account error identifies the required action.

​
Reauthorization required

An auth_required error means the payroll system requires the user to reauthorize access.
  1. Return the user to the existing account in Link.
  2. The user selects Reconnect.
  3. The user completes any required MFA step.
The user generally does not need to reenter their username and password for this error.
A user selects Reconnect to reauthorize an existing account.

​
Expired credentials

An expired_credentials error means the payroll system rejected the stored username or password.
  1. Return the user to the existing account in Link.
  2. The user opens Login help and updates their credentials with the payroll system.
  3. The user returns to Link and enters the updated credentials.
Login help directs users to update expired payroll credentials.

​
MFA

The payroll system controls which MFA methods are available and how the user receives or completes the challenge. Link displays the required input after authentication reaches the MFA step. See Completing MFA.

​
Test disconnections

In Sandbox, use the error-testing controls in Flows or the Sandbox account update endpoint to simulate account errors. See Sandbox Testing.

​
Revoking access

Users can revoke a connection from the account details in Link. They can also request help removing a connection by emailing privacy@argyle.com. After a connection is removed:
  • Data from that account is no longer available to your organization through Console or the API.
  • The accounts.removed webhook is sent for the removed account.
  • Reconnecting the same source later creates a new account ID.
See Data Security for retention and deletion guidance.

​
Monitor account status

Subscribe to the accounts.updated webhook with config.include_resource = true. When the account resource has connection.status = error, inspect the current error code and follow its remediation. Use the Account Connection Errors catalog rather than matching only the message text. Subscribe to the accounts.removed webhook to track revoked or deleted connections.