Waitlist
Review and approve signup requests before granting access to your application.
The waitlist collects sign-up 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 sign-up 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 sign-up 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 sign-up.
- 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.
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 for details on sending and accepting invitations.
- Users with verified email domains. If the user’s email domain matches a verified domain of an organization with 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.
To enable the waitlist for your account, contact us. Once enabled, you can turn it on 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.