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

# Inbox

> One list of the candidates who need a person: replies Alex held, and the follow-ups your workflows send to the Inbox.

Alex handles most of the work with candidates on its own. Now and then a candidate needs a person: they wrote back while Alex was paused, or a step in one of your workflows says a person should take over.

The **Inbox** collects those moments in one list, so nothing waits on someone remembering to check. Work through it from the top: open a candidate, do what they need, and the item moves to your **Done**.

> [!NOTE]
>
> The Inbox is in pilot: your Alex team makes it available to you. **Inbox** shows in the sidebar once they have and your role includes it. Alex adds items for every company either way, so the Inbox already holds what needed a person when it appears. If you don't see it, ask your admin whether your role includes it (see [Permissions](https://docs.alex.com/inbox/permissions.md)).

![The Inbox: the list of candidates on the left, the selected candidate's conversation on the right](https://mintcdn.com/apriora/MDTG4MwWsGXMaoCb/images/inbox/inbox-overview.png?fit=max\&auto=format\&n=MDTG4MwWsGXMaoCb\&q=85\&s=a9bf4ca8d012e0688a1f1a5c38ed5bbe)

## How the Inbox works

1. Something happens that needs a person: a candidate replies while Alex is paused, or a candidate reaches a **Send to Inbox** step in a workflow.
2. Alex adds an **item** for that candidate as soon as it happens.
3. You open the item, see why it's there, and act: reply, call, decide, or do what the item's note asks.
4. The item closes, either because of what you did or because you **Mark complete**. It moves to **Done**.

Each row in the list is one candidate on one job. If a candidate needs several things on the same job (say, a reply and a follow-up from a workflow), they share one row: the row shows the most urgent item first and a **+1** (or more) for the rest.

## What is shared and what is yours

Everyone works the same items, but each person has their own place in them:

* **Closing an item closes it for everyone.** When someone replies, decides or marks an item complete, it moves to everyone's Done.
* **Assigning an item puts it in the other person's Assigned to me**, and tells them by email. It stays open for everyone else, and for you too unless you take yourself off.
* **Snoozing, reading and Mark To do are just for you.** Nobody else's list changes.

[Using your inbox](https://docs.alex.com/inbox/using-your-inbox.md) covers each of these.

## The kinds of item

Only two kinds open now:

| In the list | What it means | What you usually do |
| - | - | - |
| **Reply** | The candidate wrote back while Alex was paused for them, so nobody has answered. | Reply in the conversation, or resume Alex. |
| **Your item types**, such as **Reference check** | A **Send to Inbox** step in a workflow sent the candidate here, as one of your company's item types, with the type's note. A step added before item types shows as **Follow up**, with its own title and note. | Do what the note asks, then mark it complete. |

Items come from **Send to Inbox** steps in your workflows. Alex no longer adds an item on its own when a candidate asks for a person, asks for an accommodation, asks something Alex couldn't answer, or finishes their interviews. To see those in the Inbox, add a **Send to Inbox** step where that happens in your workflow.

Items of those kinds that were opened earlier still show in the list, as **Wants a person**, **Accommodation**, **Question** and **Decide**, and close the way they did before, except that a **Decide** item no longer closes when the candidate stops qualifying.

When a candidate has more than one item, the row leads with them in this order: Reply, Accommodation, Wants a person, Question, Decide, then what your workflows sent.

[Item types](https://docs.alex.com/inbox/item-types.md) covers each kind: what opens it, how to work it, and what closes it.

## In this guide

> [card] [Set up the Inbox](https://docs.alex.com/inbox/set-up.md)
>
> For admins: your company's item types, and each person's preferences.

> [card] [Using your inbox](https://docs.alex.com/inbox/using-your-inbox.md)
>
> My jobs, Assigned to me, Done, snoozing, assigning and marking complete.

> [card] [Item types](https://docs.alex.com/inbox/item-types.md)
>
> Reply needed, your workflows' item types, and the older kinds that no longer open.

> [card] [Permissions](https://docs.alex.com/inbox/permissions.md)
>
> Who can see their own items, who can see everyone's, and what else they need.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.