---
title: Invite students
description: Send invites by pasting email addresses or importing a CSV roster, now, when the exam opens or at a set time.
sidebar:
  order: 4
features: [invite_import, exam_emails]
---

Students need the join code to enter an exam. You can give them the code yourself, or Hawkeye can email each student an invite. The invite email contains the join code, a link to the exam and the exam window.

> **Canvas exams**
>
> For an exam that opens from Canvas, use **Email the Class Now** in the **Canvas** section of the exam page instead. Read [Use Hawkeye with Canvas](/docs/educators/canvas).

## Share the join code

The exam page shows the **Join Code** at the top left. Students can open the join page, type the code and enter the exam. The **Invite Students** section shows the address of the join page.

## Paste email addresses

1. **Open the section**

    On the exam page, select **Invite Students** in the rail.

2. **Add the addresses**

    Type or paste the addresses into **Emails**, one address on each line.

3. **Send**

    Select **Send Now**. To send later, read [Send the invites later](#send-the-invites-later).

Hawkeye skips addresses that already have an invite for this exam. The message at the top of the page tells you how many it skipped. After each invite action, Hawkeye returns you to **Invite Students**.

![The Invite Students section with the Emails box, the Send Now button, the folded Send Later and Import From a CSV File sections and the folded "Invited (5) · 3 Scheduled" list](/docs/blume-assets/content/docs/educators/images/e11-invite-sent.png)

## Send the invites later

1. Type or paste the addresses into **Emails**.
2. Open **Send Later**.
3. Choose one:
   - To send at a set time, type the **Date and Time** and select a **Time Zone**. The time must be in the future. Then select **Schedule**.
   - To send at the open time, select **Send When the Exam Opens**. You see this button only when the exam has an open time in the future.

## Import a CSV roster

Use a CSV file to invite a whole class with names.

1. Make a CSV file. The first row is the header. It needs an `email` column. The `first_name` and `last_name` columns are optional. Hawkeye ignores other columns.
2. In **Invite Students**, open **Import From a CSV File** and choose the file under **CSV File**.
3. Select **Preview Import**. The **Import Students** page opens.
4. Check the preview. Each row shows the name, the email address and **New** or **Already Invited**. Hawkeye does not save or send anything yet.
5. Under **When**, choose when to send. Read [When the invites go out](#when-the-invites-go-out). Then select **Send Invites**.

![The Import Students page with three students marked New, the When choices, the Date and Time and Time Zone inputs and the Send Invites button](/docs/blume-assets/content/docs/educators/images/e17-csv-preview.png)

A file can have up to 200 students. If one row has a missing or incorrect email address, Hawkeye refuses the whole file. The error message gives the line number of each bad row. Correct the file and try again.

The invite email greets each student by first name when the file gives one. When a student signs up from the invite link, Hawkeye fills in the name fields from the file. The student can correct them.

## When the invites go out

On the **Import Students** page, the **When** choices are:

- **Send Now**: Hawkeye sends the invites at once.
- **When the Exam Opens**: Hawkeye sends the invites at the open time. You see this choice only when the exam has an open time in the future.
- **At a Date and Time**: type the **Date and Time** and select a **Time Zone**. The time must be in the future.

## Sent and scheduled invites

Your invites fold into one line below the form, for example **Invited (3) · 3 Scheduled**. Open it to see each invite. A sent invite shows **Sent**. A scheduled invite shows **Scheduled for** with its time.

- To stop one invite, select **Cancel** next to it. You can cancel until Hawkeye sends it.
- To move a whole batch, find the box that says how many invites are scheduled for that time. Type a **New Date and Time**, select a **Time Zone** and select **Reschedule**.

![The open Invited list with a batch of three invites scheduled for 9:00 AM EDT, its Reschedule form, and each invite with a Cancel button](/docs/blume-assets/content/docs/educators/images/e18-scheduled-batch.png)

## The "exam is open" email

If the exam has **Email invited students when the exam opens** on, students who got an invite before the open time get a second email at the open time. Read [Create an exam](/docs/educators/create-an-exam#the-exam-is-open-email).

Students who sign up with the invited email address also see the exam on their **My Exams** page. Read [Find and join your exam](/docs/test-takers/join-an-exam).