---
title: "Invite a waitlist entry"
method: POST
path: "/waitlist_entries/{waitlist_entry_id}/invite"
tags: ["Waitlist Entries"]
---

# Invite a waitlist entry

`POST /waitlist_entries/{waitlist_entry_id}/invite`

Send an invite to the email address in a waitlist entry.

## Path parameters

- `waitlist_entry_id` string, required

## Request body

- object
  - `ignore_existing` boolean, nullable — Whether an invitation should be created if there is already an existing invitation for this email address, or it's claimed by another user.

## 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
- `404` — Resource not found
- `409` — Conflict
- `422` — Invalid request parameters

---

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