---
title: "Create waitlists"
method: POST
path: "/waitlists"
tags: ["waitlists"]
---

# Create waitlists

`POST /waitlists`

## Request body

- Waitlist — Represents a patient's entry on an appointment waitlist, used to offer earlier appointment slots as they become available. It tracks the offer lifecycle from waiting through offered, accepted, or declined, along with who added the patient to the waitlist (patient, staff, or automatically by the system).
  - `_id` string, required — Luma's internal ID of an object.
  - `user` string — The ID of the root account user.
  - `deleted` 0 | 1 — Flag for logical deletion where 1 means deleted.
  - `createdBy` string — The ID of the user who created this object.
  - `updatedBy` string — The ID of the user who updated this object.
  - `createdAt` string, date-time — The date/time when this object was created.
  - `updatedAt` string, date-time — The date/time when this object was updated.
  - `patient` string
  - `provider` string
  - `facility` string
  - `facilities` string[]
  - `appointmentType` string
  - `offer` string
  - `status` 'waiting' | 'in-flight' | 'offered' | 'confirming' | 'accepted' | 'pending' | 'declined'

## Response `200`

Returns the created waitlists

- Waitlist — Represents a patient's entry on an appointment waitlist, used to offer earlier appointment slots as they become available. It tracks the offer lifecycle from waiting through offered, accepted, or declined, along with who added the patient to the waitlist (patient, staff, or automatically by the system).
  - `_id` string, required — Luma's internal ID of an object.
  - `user` string — The ID of the root account user.
  - `deleted` 0 | 1 — Flag for logical deletion where 1 means deleted.
  - `createdBy` string — The ID of the user who created this object.
  - `updatedBy` string — The ID of the user who updated this object.
  - `createdAt` string, date-time — The date/time when this object was created.
  - `updatedAt` string, date-time — The date/time when this object was updated.
  - `patient` string
  - `provider` string
  - `facility` string
  - `facilities` string[]
  - `appointmentType` string
  - `offer` string
  - `status` 'waiting' | 'in-flight' | 'offered' | 'confirming' | 'accepted' | 'pending' | 'declined'

## Other responses

- `401` — Not authenticated
- `403` — Access token does not have the required scope
- `default` — unexpected error - need to finalize the error codes

---

[API](https://skmtc.net/lumahealth/apis/rest-service.md) · [All operations](https://skmtc.net/lumahealth/apis/rest-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lumahealth/rest-service/revisions/d3c75c2a2f1d/schema)