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

# Accounts

> Every payroll connection creates a new account.

## Definition

"Accounts" represent sources of income for a user.

<Frame>
  <img src="https://mintcdn.com/argyle/lpddaw6ggr_B1oHD/images/argyle-guides/overview/accounts/accounts.png?fit=max&auto=format&n=lpddaw6ggr_B1oHD&q=85&s=f80164990575c08b917657803876362a" alt="What accounts are in Argyle terminology." width="2700" height="1044" data-path="images/argyle-guides/overview/accounts/accounts.png" />
</Frame>

Users log in to their accounts through Link by searching through various [Items](/overview/data-structure/items) and finding the one that matches the entity that sends them payments. Once a match is found, the user enters their login credentials and connects their account.

## Standard connection process

Without any customizations, the standard payroll connection process in Link is as follows:

<Tabs>
  <Tab title="Step 1">
    The user searches from a general list of potential incomes sources. This includes employers, government entities, and payroll services.

    <Frame>
      <img src="https://mintcdn.com/argyle/0Z2zBY-iD5Q5BvPN/images/argyle-guides/link/analytics/2-search-screen.png?fit=max&auto=format&n=0Z2zBY-iD5Q5BvPN&q=85&s=1e4bb8b3317fc3a242c8faaf630ed961" alt="Search screen in Link." width="2100" height="1350" data-path="images/argyle-guides/link/analytics/2-search-screen.png" />
    </Frame>
  </Tab>

  <Tab title="Step 2">
    If the user cannot find their source of income from this general list, they will be prompted to search from a list of only payroll providers that service multiple employers.

    <Frame>
      <img src="https://mintcdn.com/argyle/lpddaw6ggr_B1oHD/images/argyle-guides/workflows/account-connections/2-account-connections.png?fit=max&auto=format&n=lpddaw6ggr_B1oHD&q=85&s=62cb71373764ff4af23f940c714740b1" alt="Can't find income source screen in Link." width="2100" height="1350" data-path="images/argyle-guides/workflows/account-connections/2-account-connections.png" />
    </Frame>

    <Note>
      These payroll providers are searchable in step 1, but we have found narrowing the search focus to payroll providers improves the connection success rate for users.
    </Note>
  </Tab>

  <Tab title="Step 3">
    If the user successfully finds their source of income, they are taken to its respective login screen. From the login screen, the user can enter their login credentials to connect their account.

    <Frame>
      <img src="https://mintcdn.com/argyle/0Z2zBY-iD5Q5BvPN/images/argyle-guides/link/analytics/3-login-screen.png?fit=max&auto=format&n=0Z2zBY-iD5Q5BvPN&q=85&s=22a866e61fab748d61da3553ab4a8dea" alt="Login screen in Link." width="2116" height="1366" data-path="images/argyle-guides/link/analytics/3-login-screen.png" />
    </Frame>

    * If the user cannot remember their login credentials, the login screen provides a link to the platform's username/password reset process.
    * Each login screen is tailored to match the input fields used by the underlying payroll system. For example, some systems require a username and password, others an email and password, while others may use SSO methods to login. You can preview the login screen for any employer or payroll system in the <a href="https://console.argyle.com/flows" target="_blank">Flows</a> section of Console.
  </Tab>

  <Tab title="Step 4">
    If the user cannot ultimately find their source of income, they are asked to submit a response form and list their employers or payroll providers.

    <Frame>
      <img src="https://mintcdn.com/argyle/lpddaw6ggr_B1oHD/images/argyle-guides/workflows/account-connections/4-account-connections.png?fit=max&auto=format&n=lpddaw6ggr_B1oHD&q=85&s=3f9271523e114f21e6af3f1f65bb67bd" alt="Response form screen in Link." width="2100" height="1350" data-path="images/argyle-guides/workflows/account-connections/4-account-connections.png" />
    </Frame>
  </Tab>
</Tabs>

## Connection types

A new account is created for a user in four scenarios:

* A connection is successful.
* A connection was attempted but was not successful.
* A document was manually uploaded.
* A response form was submitted if the user could not locate their source of income.

### Successful connections

An account connection is considered successful when a user submits their login credentials through Link and Argyle successfully authenticates the payroll account using the provided login credentials. Once an account is successfully connected, Argyle immediately begins [data retrieval and delivery](/overview/data-delivery).

Visit our [Workflows Guides](/workflows/reconnecting-accounts) if you need more information related to re-verifying a disconnected account, completing MFA, or allowing users to revoke access to a connected account.

### Attempted connections

A new account is created for a user if they enter their login credentials in Link and click **Connect**, but the account connection is unsuccessful. Details on why an account connection attempt was unsuccessful are shown when viewing the account via Console or the API.

### Document uploads

A new account is created for a user if they manually upload any documents in Link, even if they do not connect a payroll account. Visit our [Document Processing Guide](/workflows/document-processing) to learn how to enable document uploading in Link.

### Form submissions

A new account is created for a user if they are unable to locate their source of income in Link search, but when prompted proceed and submit a response form ([Step 4](/overview/data-structure/accounts#standard-connection-process)) asking them about their sources of income.

## Viewing user accounts

<div className="argyle-divider" />

### Console

Navigate to the <a href="https://console.argyle.com/connections" target="_blank">Connections</a> section of Console, where attempted and successfully connected accounts are shown next to each user. Hover over an account to display more information including when data from connected accounts was most recently synced.

View individual account information by selecting an individual user.

* A **Connections** section at the top of the individual user's page will show information on each account the user has ever successfully connected. Revoked connections will disappear from the user's page in 30 days.

<Note>
  An indicator will appear if the account has become disconnected and needs to be [reconnected](/workflows/reconnecting-accounts).
</Note>

* A **Form Responses** tab will be shown in the main part of the user's page if a response form ([Step 4](/overview/data-structure/accounts#standard-connection-process)) was submitted.

### API

Use the API's [`/accounts`](/api-reference/accounts) endpoint to retrieve information for a single account connection, list all accounts, or delete an account.
