---
title: "Join Waitlist"
method: POST
path: "/api/v1/subscriptions/waitlist"
tags: ["subscriptions"]
---

# Join Waitlist

`POST /api/v1/subscriptions/waitlist`

## Request

- Base URL: `https://api.alert.camp` (the document declares no server; this is the origin it was published from)
- URL: `https://api.alert.camp/api/v1/subscriptions/waitlist`
- Auth: none declared

Join the waitlist for a tier that is at capacity.

Uses the authenticated user's email and ID.
Duplicate (email, tier) pairs are handled gracefully.

## Headers

- `authorization` string, nullable
- `x-dev-user-id` string, nullable
- `x-app-version` string, nullable

## Request body

- WaitlistRequest: Request schema for joining a tier waitlist.
  - `desired_tier` 'essai' | 'regular' | 'pro', required: Subscription tier levels.

## Response `201`

Successful Response

- WaitlistResponse: Response schema for waitlist operations.
  - `message` string, required
  - `already_registered` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/alert/apis/alertcamp.md) · [All operations](https://skmtc.dev/alert/apis/alertcamp/llms.txt) · [OpenAPI document](https://skmtc.dev/alert/apis/alertcamp/revisions/864c8c9ef833?raw)
