<!-- llms.txt: https://workos.com/llms.txt -->

# Waitlist

## Introduction

The waitlist collects signup requests and lets you review them before users can register. This is useful for gated launches, closed betas, or any application that requires vetting users before they can sign up.

When the waitlist is enabled, the AuthKit signup form is replaced with a form that collects the user's email and adds them to the waitlist. Each entry appears in the WorkOS dashboard where it can be approved or denied individually.

## How the waitlist works

When a user joins the waitlist from the AuthKit signup form, a pending entry is created for their email address. From the "Waitlist" tab in the "Users" section of the WorkOS dashboard, each entry can be:

- **Approved.** The user receives an email with a link to complete their signup.
- **Denied.** The entry is marked as denied and the user is not notified.

Waitlist entries are scoped to an environment, so entries collected in a staging environment are kept separate from production.

## Who can sign up when the waitlist is enabled

When the waitlist is enabled, users cannot register for a new account through the AuthKit signup form or the API. Existing users can still sign in.

The following users can still sign up:

- **Invited users.** When a valid invitation code is present in the sign-in flow, registration is opened up so that the invited user may sign up. See [Invitations](https://workos.com/docs/authkit/invitations) for details on sending and accepting invitations.
- **Users with verified email domains.** If the user's email domain matches a [verified domain](https://workos.com/docs/authkit/domain-verification) of an organization with [JIT provisioning](https://workos.com/docs/authkit/jit-provisioning) enabled, a new user is created and added to the organization. Pre-configured domain access is honored so members of known organizations aren't routed through the waitlist.

## Enabling the waitlist

To enable the waitlist for your account, [contact us](mailto:support@workos.com?subject=AuthKit%20Waitlist). Once enabled, you can turn it on per environment from the authentication section of the WorkOS [dashboard](https://dashboard.workos.com/).

## Waitlist webhooks

WorkOS emits webhook events when waitlist entries change state:

- `waitlist_user.created` — a new user joined the waitlist.
- `waitlist_user.approved` — an entry was approved.
- `waitlist_user.denied` — an entry was denied.

Subscribe to these events by [creating a webhook endpoint](https://workos.com/docs/reference/webhooks/create) in the WorkOS dashboard. This lets you plug the waitlist into review workflows in other systems, such as auto-approving entries from known email domains or notifying a Slack channel when new entries arrive.
