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

<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" />

A **Linked Account** is one end-user's authenticated connection to one provider — 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>
