Review and approve signup requests before granting access to your application.
The waitlist collects signup requests and lets you review them before users are given an account. 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.
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:
Waitlist entries are scoped to an environment, so entries collected in a staging environment are kept separate from production.
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:
The waitlist can be enabled per environment from the authentication section of the WorkOS dashboard.
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 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.