---
title: "Create a waitlist item"
method: POST
path: "/clients/{client_id}/waitlist_items"
tags: ["Waitlist Items"]
---

# Create a waitlist item

`POST /clients/{client_id}/waitlist_items`

Create a new waitlist item for a client

## Path parameters

- `client_id` string, required

## Headers

- `X-Subdomain` string

## Request body

- object
  - `location_id` integer — Location ID
  - `employee_id` integer — Employee ID
  - `variation_ids` string — Comma-separated variation IDs
  - `begin_at` string, date-time — Start time (ISO8601 format)
  - `end_at` string, date-time — End time (ISO8601 format)
  - `kind` 'appointment' | 'session' — Type of waitlist item
  - `session_id` integer — Session ID (required if kind is session)
  - `attendee_ids` integer[] — Attendee IDs (required if kind is session)
  - `attendee_quantities` integer[] — Attendee quantities (required if kind is session)

## Response `201`

Waitlist item created

- WaitlistItem
  - `id` integer
  - `client_id` integer
  - `location_id` integer
  - `employee_id` integer
  - `child_id` integer
  - `kind` 'appointment' | 'session'
  - `begin_at` string, date-time
  - `end_at` string, date-time
  - `session_id` integer
  - `variations` unknown[]
    - unknown
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized
- `422` — Invalid parameters
- `500` — Internal Server Error
- `504` — Gateway Timeout

---

[API](https://skmtc.net/mytime/apis/mytime-partners-api.md) · [All operations](https://skmtc.net/mytime/apis/mytime-partners-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mytime/mytime-partners-api/versions/65d3a27fcb1a/schema)