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

# Invite Candidates and review results

> Send role play invites, follow each session, and read the scored report.

You can invite people to a published role play directly, or add Candidates from an Interviewer's Candidate list. Each person gets a unique link and one attempt.

## Invite Candidates directly

1. Click **Role Plays** in the sidebar and open a published role play.
2. Click **Invite** at the top right of the page.
3. Choose how to add people:
   * **Add manually**: enter a **Name** and **Email** for each person. Click **Add another** for more rows, up to 50.
   * **Upload CSV**: choose a CSV file with a name column and an email column. You can upload up to 500 rows. The rows appear in a preview, and any problems are shown next to each row.
4. Check **Link expiry (days)**. It starts at the role play's link expiry setting and can be from 1 to 30 days.
5. Click **Send invites**.

The dialog lists anyone who wasn't invited and why, for example because they were already invited to this role play.

<Note>
  You can invite Candidates only after the role play is published.
</Note>

## Add Candidates from an Interviewer

1. Open an Interviewer and go to its Candidate list.
2. Do one of the following:
   * For one Candidate, open the row menu and click **Add to role play**.
   * For several Candidates, select them, open the bulk actions menu, and click **Add to role play**.
3. In **Role play**, choose a published role play.
4. Click **Send invites**.

Each Candidate gets an email with a unique link. Their stage changes to **Shortlisted for Role Play**. Candidates who were already invited to that role play are skipped, and you see a message with the reason.

### From the Candidate's report

You can also add one Candidate from their report:

1. Open the Candidate from an Interviewer's Candidate list.
2. Click the **Role Play** tab.
3. If the Candidate has no role play yet, click **Add to role play**.
4. Choose a published role play and click **Send invites**.

The tab then shows the new role play. Click **View Role Play** to open the Candidate's full role play report.

Results appear on the role play and in the Candidate's report, on the **Role Play** tab. If a Candidate took more than one role play, choose which one to view from the **Role play** menu on that tab.

## What the Candidate experiences

1. The Candidate opens the link from their email.
2. The join page shows the role play title, their brief (**Your role**, **Situation**, and **Objective**), any reference materials and tips, and what they'll be assessed on, if you chose to show it.
3. It also lists key facts: the call length, that it's a live voice call, that they get one attempt, the language, and whether a camera or a laptop is required.
4. The Candidate clicks **Join role play**. The call opens in a new tab and starts straight away. Their brief stays on screen during the call.
5. The call ends when the time limit is reached, or when one of the role play's end conditions happens, such as the objective being reached.

If you turned on **Let candidates opt out** for the role play, the join page also shows an opt-out link.

If **Desktop only** is on, the Candidate can't join from a phone. The join page also tells the Candidate when:

* the link has expired;
* the role play has already been completed;
* they opted out.

## Track sessions

Open the role play and click the **Candidates** tab. The table shows everyone invited, directly or from an Interviewer:

| Column | What it shows |
| - | - |
| **Candidate** | Name and email. Candidates added from an Interviewer also show "From job:" and the Interviewer name. |
| **Status** | The session status. See below. |
| **Score** | The score out of 100, once graded. |
| **Invited** | When the invite was sent. |
| **Completed** | When the call ended. |

Above the table:

* **Search**: find a Candidate by name or email.
* **Sort**: click the sort button and choose **Newest invite**, **Oldest invite**, **Highest score**, **Lowest score**, or **Recently completed**.
* **Status tabs**: click a status to filter the table. Each tab shows how many Candidates have that status.

### Session statuses

| Status | What it means |
| - | - |
| **Shortlisted** | Invited, but hasn't started yet. |
| **In progress** | The call is live, or it has ended and is being graded. |
| **Completed** | Graded. The report is ready. This session uses 2 credits. |
| **Not scored** | There wasn't enough to grade, for example a very short call. You're not charged. |
| **Grading failed** | Something went wrong while grading. Contact support if you see this. |
| **Expired** | The link expired before the Candidate started. |
| **Opted out** | The Candidate opted out from the join page. Only possible when **Let candidates opt out** is on. |

### Row actions

Open the menu on a row to:

* **View report**: open the session report.
* **Resend invite**: send the invite again with the same link. Available while the invite is waiting and hasn't expired.
* **Delete**: remove a Candidate you invited directly by email. If they haven't started, their link stops working. You can invite them to this role play again later. Not available while their call is in progress, or for Candidates added from an Interviewer.

## Read the report

Click a row, or choose **View report**, to open the **Role play report**. Results usually appear a few minutes after the call ends.

The top of the report shows:

* The session status and the score out of 100.
* The AI recommendation, such as **Strong yes**, **Yes**, **Leaning yes**, **Neutral**, or **No**.
* Whether the objective was achieved, partially achieved, or not achieved.
* The call duration, and when the Candidate was invited and completed it.

Below that you find:

* **Summary**: an overview of the call, the reasoning behind the objective result, and lists of **Strengths**, **Gaps**, **Red flags**, and **Notes for the human interviewer**. When an item mentions a moment in the call, such as (1:05), click the time to play the recording from there.
* **Criteria**: a card for each criterion with its score, the reasoning, and evidence from the conversation. Must-pass criteria scored 2 or lower are flagged. If a recording is available, you can jump to the moment the evidence comes from.
* **Hidden facts uncovered**: which hidden facts the Candidate managed to uncover.
* **Recording & transcript**: the call recording and the full transcript, when available.

Each session is graded once, when the call ends. Editing the role play's criteria later doesn't change results that were already graded.

### Export the report as a PDF

* On the **Role play report**, click **Export PDF** to download the report for this session.
* On a Candidate's report, **Export PDF** includes a **Role Play** section for each role play the Candidate was added to from an Interviewer.

The PDF includes the score, recommendation, objective, summary, criteria scores and reasoning, strengths, gaps, red flags, notes, hidden facts, and the transcript. When a recording is available, click **Watch Recording** in the PDF to open it. Anyone with the PDF can open the recording link, so share it carefully.

## Related docs

* [Role plays overview](/role-plays/overview)
* [Create a role play](/role-plays/create-a-role-play)


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