Skip to main content

Invitations

The invitation system allows you to create access codes that new users use to sign up and automatically enroll in specific courses.

How it works

Each invitation generates a unique 7-character code (e.g., AB2K7MZ) that can be shared via link or entered manually. When someone accepts the invitation:
  1. If they are a new user -> account created automatically with “student” role
  2. If they already have an account -> enrolled in the invitation’s course
  3. The usage is recorded for tracking

Creating an invitation

1

Go to Admin -> Invitations

Click “New invitation”
2

Fill in the fields

Set a title and select the associated course.
3

Configure limits (optional)

Set a usage limit and/or expiration date.
4

Generate the code

The system automatically generates a unique 7-character code.
5

Share

Copy the link or code and send it to prospective students.

Invitation fields

FieldRequiredDescription
TitleYesIdentifying name for the invitation
CourseYesCourse the user will be enrolled in
DescriptionNoAdditional information about the invitation
Background imageNoImage displayed on the acceptance page
Usage limitNoMaximum number of times the invitation can be used. Empty = unlimited.
Expiration dateNoDeadline to accept the invitation. Empty = no expiration.

Invitation types

Set limite_usos = 1 to create an exclusive invitation for one person.

Acceptance flow

When a user accesses the invitation link:
1

Invitation page

The user sees the invitation title, description, and image.
2

Fills in name and email

Required fields for identification.
3

Account created or linked

If the email already exists, the user is enrolled in the course. If not, a new account is created with the “student” role.
4

Email sent

New users receive a welcome email with the access password.
New users created via invitation receive the require_change_password flag, prompting a password change on first login.

Abuse protection

The invitation system has rate limits to prevent abuse:
  • Per IP: maximum 5 attempts every 15 minutes
  • Per email: maximum 3 attempts per hour

Tracking

For each invitation, you can view:
  • Current uses - How many times the invitation has been accepted
  • Acceptance list - Who accepted, when, and with which email
  • Status - Active, expired, or limit reached
  • Remaining spots - If there is a limit, how many spots remain

Managing invitations

ActionDescription
EditChange title, description, limits, and expiration
DeactivateDisable the invitation without deleting it (soft delete)
FilterBy course or status (active/inactive)

Permissions

  • Owner and Admin: can create and manage any invitation
  • Professor: can create invitations only for courses they created or in which they are an associated professor

Next steps

Member management

Manage existing users

Settings

Configure the default password for new members