User Invitations

Learn how to create custom, secure, and flexible invitations for new members.

The new invitation system gives you precise control over how members join your organization, allowing you to streamline onboarding and enhance security.

You can create highly customized invitations for any scenario, from onboarding specific individuals to launching large-scale community challenges. Each invitation can be configured with expiration dates, usage quotas, and pre-assigned roles, ensuring new members get the right access from the moment they join.

The invitation system provides three main areas of control to help you manage access effectively.

Tailor each invitation to your specific needs with three flexible modes:

  • Precise invitation: Target a single user by specifying their full email address.
  • Domain-wide invitation: Onboard an entire organization at once by allowing any email from a specific domain (e.g., *@layer5.io).
  • Public invitation: Leave the email field blank to create an open link for public events (e.g., Academy Challenge invitations).

Manage access with settings that put you in control:

  • Expiration date: Set a specific date and time for an invitation to automatically become invalid.
  • Usage quota: Limit the number of times an invitation can be used.

Instantly revoke access by switching an invitation’s status between enabled and disabled at any time.

PropertyDescription
nameA name used to identify the invitation.
descriptionAdditional information about the invitation’s purpose.
emailsList of email addresses or domain patterns allowed to use the invitation. If empty, the invitation is public.
expiresAtDate when the invitation becomes invalid. If not set, it never expires.
quotaNumber that limits how many users can accept the invitation. If not set, there’s no usage limit.
rolesList of roles automatically assigned to new members upon accepting the invitation.
teamsList of teams new members are automatically added to upon accepting the invitation.

The invitation system offers flexible configurations to fit a variety of use cases.

  • Goal: Provide a new employee with a secure, single-use invitation that grants the correct initial permissions.
  • Configuration:
    • Email: Set to the new member’s specific email.
    • Roles: Assign their specific role (e.g., Developer).
    • Teams: Add them directly to their project team (e.g., Frontend-Team).
    • Quota: Set to 1 to ensure the link is only used once.
  • Goal: Allow all employees from your company to join using their corporate email without individual invitations.
  • Configuration:
    • Email: Use a domain pattern to cover all employees.
    • Roles: Assign a default role for all new members.
  • Goal: Create a public signup link for a limited-time community event with a maximum number of participants.
  • Configuration:
    • Email: Leave blank for public access.
    • Name: Give it a clear name like “Layer5 Challenge 2025”.
    • Expiration date: Set to the date and time the challenge registration closes.
    • Quota: Set to the maximum number of participants (e.g., 100).
    • Roles: Assign a temporary role like Learner.
  • Goal: Give an external partner secure access to specific resources only for the duration of a project.
  • Configuration:
    • Email: Use the partner’s domain (e.g., *@partner.com).
    • Teams: Add them only to a shared project team (e.g., Project-X-Shared).
    • Expiration date: Set to the project’s end date to revoke access.
    • Description: Add a note for internal reference, such as “Temporary access for Project X contractors”.
Last modified August 20, 2025: update (b175a789)