Skip to main content

​
POST /api/waitlist

Adds an email address to the PriceSignal waitlist. This endpoint is typically used during beta or pre-launch phases to collect interested user emails.

​
Request Body

​
email
string
required
The email address to add to the waitlistMust be a valid email format

​
Authentication

No authentication required. This is a public endpoint.

​
Behavior

  1. Accepts an email address as a string parameter
  2. Creates a new waitlist entry in the database
  3. Silently handles duplicate email entries (no error returned)
  4. Always returns HTTP 200 OK, even if the email already exists

​
Response

​
status
number
HTTP status code: 200 for success

​
Examples

curl -X POST https://api.pricesignal.app/api/waitlist \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

​
Request Example

{
  "email": "[email protected]"
}

​
Response Example

{
  "status": 200
}
This endpoint gracefully handles duplicate email submissions. If an email already exists in the waitlist, the endpoint will still return success (HTTP 200) without raising an error.

​
Error Handling

The endpoint is designed to be fault-tolerant:
  • Duplicate emails are silently ignored
  • Database errors are caught and suppressed
  • Always returns HTTP 200 OK to prevent information leakage about existing waitlist entries
This approach prevents attackers from enumerating waitlist members while providing a smooth user experience.

Build docs developers (and LLMs) love

Get started for freeTalk to us