Sign Up for the Waitlist

Endpoint

POST /waitlist

Server: https://api.openfish.fun (port 3002)

Auth: None

Tags: Waitlist

The email is lowercased and trimmed before storage. If it already exists, the response indicates "new": false and no duplicate entry is created. This endpoint does not trigger any email delivery; notification handling occurs separately.

---

Body

Field	Type	Required	Description
email	string	Yes	Email address. Basic validation: non-empty, contains @ and .
source	string	No	Where the signup originated (e.g., "website", "twitter"). Defaults to "website"

{
  "email": "builder@example.com",
  "source": "website"
}

---

Response

200 — Signup recorded.

{
  "ok": true,
  "email": "builder@example.com",
  "new": true
}

• new: true — This is the first registration for this email.
• new: false — The email was already on the list; nothing changed.

400 — { "error": "invalid email" } when the email fails basic validation.

500 — { "error": "server error" } on database failure.

---

Usage

curl -X POST "https://api.openfish.fun/waitlist" \
  -H "Content-Type: application/json" \
  -d '{"email": "builder@example.com", "source": "docs"}'