---
title: "Join the waitlist"
description: "Puts an email on the waitlist without creating an account or sending a code, for use while Cool Computers is full (GET /api/signup); when the owner lets the email in, an invitation arrives there and…"
canonical: "https://www.cool.computer/docs/api-reference/authentication/join-the-waitlist"
---
# Join the waitlist

> Puts an email on the waitlist without creating an account or sending a code, for use while Cool Computers is full (GET /api/signup); when the owner lets the email in, an invitation arrives there and…

```http
POST https://api.cool.computer/api/waitlist
```

Puts an email on the waitlist without creating an account or sending a code, for use while Cool Computers is full (`GET /api/signup`); when the owner lets the email in, an invitation arrives there and signing up with it then works. Call it only with the address the user gave you. It answers the same whether the email is new, already waiting, or already has an account. Each API process admits at most 10 joins an hour from one address (an IPv6 /64), 20 from one IPv6 /48 and 1000 from everyone; past that it answers 429 waitlist_rate_exceeded with Retry-After seconds.

## Authorization

No credential is needed.

## Request body

Required.

- `application/json` (object)
  - `email` (string, email, required)

## Responses

- `202`: The email is on the waitlist.
  - `application/json` (object)
    - `status` ("waitlisted", required)
- `400`: Bad Request: not one email address.
- `429`: Too Many Requests. If the problem code is api_request_rate_exceeded, wait for Retry-After seconds; other problem codes describe a separate limit.
- `500`: Internal Server Error.
- `503`: Service Unavailable.
- `default`: A machine-readable API error with a stable code and recovery instruction.

An error is an `application/problem+json` document with a stable `code`; [API errors](/docs/api-reference/errors) says how to handle one.

## Example

```sh
curl -X POST "https://api.cool.computer/api/waitlist" \
  -H "content-type: application/json" \
  --data '{"email":"ana@example.com"}'
```
