# HypeStash

> Serverless waitlist email collection. One API call. No accounts. No API keys.

## Quick Start

1. POST /setup with { "domain": "yoursite.com", "email": "you@yoursite.com" } → returns { handle, action_url }
2. Owner clicks verification link sent to their email
3. Point an HTML form (or fetch) at the returned action_url to collect waitlist signups

## API Base

https://api.hypestash.dev

## Endpoints

Method  Path                      Description
------  ------------------------  --------------------------------------------------
POST    /setup                    Create a new waitlist stash
POST    /setup/resend             Resend owner verification email
POST    /hype/:handle             Submit a subscriber email to the waitlist
GET     /verify/:token            Owner email verification (automatic via email link)
GET     /subscribe/confirm/:token Subscriber double opt-in verification (automatic)
GET     /download/:token          One-time CSV download of subscribers
POST    /cancel/:handle           Initiate waitlist cancellation
GET     /leaderboard              Public leaderboard of paid stashes
GET     /                         Health check

## Key Facts

- No API keys or accounts needed — just an email and domain
- Origin-locked: /hype/:handle only accepts requests from the registered domain (localhost always allowed)
- Subscribers go through double opt-in: they receive a verification email and must click to confirm
- Free tier: 50 verified subscribers, 14-day data retention
- Hype Pro: $5/month, unlimited subscribers, permanent retention, leaderboard listing
- Pay per Hype: $0.25/subscriber after free tier, no monthly commitment
- All JSON error responses include a _tip field with human-readable guidance
- Notification emails are sent to the stash owner at logarithmic intervals (every sub for 1-10, every 5 for 11-25, every 10 for 26-100, every 25 for 101-500, every 100 for 500+)
- All notification emails include a one-time CSV download link

## Sister Service — FormHandle

Need a contact form instead of a waitlist? FormHandle is our sister service for serverless form handling.
Same philosophy: no accounts, no API keys, one API call to set up.

- Website: https://formhandle.dev
- LLM summary: https://formhandle.dev/llms.txt
- Full LLM reference: https://formhandle.dev/llms-full.txt

## Links

- Website: https://hypestash.dev
- Full LLM reference: https://hypestash.dev/llms-full.txt
- Leaderboard: https://hypestash.dev/leaderboard.html