Employment History

Prompt users in Link to add additional employments until required employment history length is met.

Overview#

Employment History is a new payroll connection experience in Link:

  • Users are asked to connect their payroll accounts until a threshold length of employment history has been met.
  • The employment history threshold is configurable from 1 month up to 10 years and 11 months.
  • After each connection Argyle checks to see if the employment history threshold has been met. If not, the user is prompted to connect additional accounts.

To enable the Employment History feature, reach out to your Argyle customer success manager.

No employment history check#

Standard Link connection experience (Employment History feature is not enabled):

Employment history sufficient#

Employment History feature is enabled and connected account meets minimum history threshold:

Employment history insufficient#

Employment feature is enabled and connected account does not meet minimum history threshold:

Console setup#

  1. Navigate to the Link Flows section of Console and create a New Flow.

    The Employment History feature can be enabled for both all Flow types.

  2. In General Settings tab, enable the Employment history minimum toggle.

  3. Adjust the sliders to your desired minimum employment history length.

  4. (Optional) When Employment History is enabled, a unique intro screen is enabled by default. This screen can be customized within the Intro screen side tab.

  5. (Optional) The screen shown when sufficient employment history is reached can be customized from the Completion side tab.

  6. (Optional) The screen shown for insufficent employment history can also be adjusted from the same Completion side tab.

Reach out to your Argyle Success Manager for any setup assistance.

Embedded routing#

For embedded implementations, the onClose Link callback can be used to route users depending on whether the employment history threshold was met:

  • When onClose returns "userSubmissionComplete": true this indicates the employment history threshold has been met. The user can be routed forward in your experience.
  • When onClose returns "userSubmissionComplete": false this indicates the employment history threshold was not met. The user can be routed to a fallback experience.

Limitations#

  • Deposit switching is not supported when combined with Flows that have Employment History enabled.
  • It can take up to ~30 seconds after each connection for employment history from the account to be evaluated.

Testing#

In Argyle Sandbox:

  1. Create a Flow with Employment History enabled.
  2. Initiate a Link connection experience with the saved Flow.
  3. To test sufficient employment history:
    • Use test_1 as the username
    • Use passgood as the password
  4. To test insufficient employment history:
    • Use test_1 as the username
    • Use the following password:
      1eyJzdGF0aWNfZGF0YV9zZXRfaWQiOiAiODRjZGVmMWQtNWQ4Ny00NGNmLWJmYTYtNzI2ZDIwODExODI0IiwgImluaXRpYWxfc2Nhbl9kZWxheV9pbl9zZWNvbmRzIjogN30K
  5. To test slow data retrieval time (extended waiting period):
    • Use test_1 as the username
    • Use the following password:
      1eyJzdGF0aWNfZGF0YV9zZXRfaWQiOiAiODdkZjg4MDctMDZmYy00OTUxLWFiYzYtMWVmNjI2ZDUyOWE5IiwgImluaXRpYWxfc2Nhbl9kZWxheV9pbl9zZWNvbmRzIjogMjB9
Updating Argyle status...
© 2025 Argyle Systems Inc.argyle.com