---
title: "Create multiple waitlist entries"
method: POST
path: "/waitlist_entries/bulk"
tags: ["Waitlist Entries"]
---

# Create multiple waitlist entries

`POST /waitlist_entries/bulk`

Creates multiple waitlist entries for the provided email addresses.
You can choose whether to send confirmation emails by setting the `notify` parameter to `true` or `false` for each entry.
If the `notify` parameter is omitted, it defaults to `true`.

If an email address is already on the waitlist, no new entry will be created and the existing waitlist entry will be returned.
Duplicate email addresses within the same request are not allowed.

This endpoint is limited to a maximum of 50 entries per API call. If you need to add more entries, please make multiple requests.

## Request body

- object[]
  - `email_address` string, email, 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`

Array of waitlist entries

- 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)