---
title: "Create a waitlist entry"
method: POST
path: "/waitlist_entries"
tags: ["Waitlist Entries"]
---

# Create a waitlist entry

`POST /waitlist_entries`

Creates a new waitlist entry for the given email address.
If the email address is already on the waitlist, no new entry will be created and the existing waitlist entry will be returned.

## Request body

- object
  - `email_address` string, required — The email address to add to the waitlist
  - `notify` boolean, nullable — Optional flag which denotes whether a confirmation email should be sent to the given email address. Defaults to `true`.

## Response `200`

A Waitlist Entry

- WaitlistEntry
  - `object` 'waitlist_entry', required
  - `id` string, required
  - `email_address` string, email, required
  - `status` 'pending' | 'invited' | 'rejected' | 'completed', required
  - `is_locked` boolean — Indicates if the waitlist entry is locked. Locked entries are being processed in a batch action and are unavailable for other actions.
  - `created_at` integer, required — Unix timestamp of creation.
  - `updated_at` integer, required — Unix timestamp of last update.
  - `invitation` Invitation
    - `object` 'invitation', required
    - `id` string, required
    - `email_address` string, email, required
    - `public_metadata` object, required
    - `revoked` boolean
    - `status` 'pending' | 'accepted' | 'revoked' | 'expired', required
    - `url` string
    - `expires_at` integer, nullable — Unix timestamp of expiration.
    - `created_at` integer, required — Unix timestamp of creation.
    - `updated_at` integer, required — Unix timestamp of last update.

## Other responses

- `400` — Request was not successful
- `422` — Invalid request parameters

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/75df3a43fcb2/schema)