> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linked Accounts

> An end-user's authenticated connection to a provider.

<Frame>
  <img src="https://mintcdn.com/stackone-60/eqCjS7m4FAN_3XTx/images/concepts-linked-accounts.svg?fit=max&auto=format&n=eqCjS7m4FAN_3XTx&q=85&s=3d2d45ef8fe6b04de10e72cdaf0235c8" alt="Where Linked Accounts sit in StackOne: each account comes off a connector profile inside your project and represents one end-user's connection to a connector." style={{ width: "100%", maxWidth: "420px", margin: "1.5rem auto 2rem", display: "block" }} width="420" height="524" data-path="images/concepts-linked-accounts.svg" />
</Frame>

A **Linked Account** is one end-user's authenticated connection to one provider, whether that's their Salesforce, Slack, or whichever system they use. StackOne creates it when they connect and stores the credentials.

If you serve many customers, see [Multi-Tenant Accounts](/features/multi-tenant-accounts) for keeping their accounts separate.

## Account status

An account's status tells you whether it can currently serve calls.

| Status        | Meaning                                                                                                                                         |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Active**    | Credentials are valid and the account is serving calls.                                                                                         |
| **Suspended** | Manually paused, so no actions can be called against it. Credentials stay saved, so the account can be resumed later without re-authenticating. |
| **Error**     | Calls are failing, usually expired credentials or revoked provider access. Re-authenticate the account to recover it.                           |

<Tip>
  Subscribe to the `account.updated` and `account.deleted` [webhook events](/embed/handle-account-events) to react to status changes instead of polling.
</Tip>

## Related

<CardGroup cols={2}>
  <Card title="Account Linking" icon="link" href="/embed/account-linking/overview">
    The ways your end-users connect their accounts.
  </Card>

  <Card title="Multi-Tenant Accounts" icon="sitemap" href="/features/multi-tenant-accounts">
    Segment, list, and monitor accounts per customer.
  </Card>

  <Card title="Handle Account Events" icon="bell" href="/embed/handle-account-events">
    React when accounts are created, re-authenticated, or removed.
  </Card>

  <Card title="Team Management" icon="users" href="/secure/team-management#project-members">
    Which project roles can view, edit, and delete accounts.
  </Card>

  <Card title="Troubleshooting" icon="scroll" href="/connect/troubleshooting">
    Inspect request logs for a failing account.
  </Card>
</CardGroup>
