Documentation

Everything you need to embed WarpList on your landing page.

Quick Start

Step 1 — Create a waitlist

Sign up at /dashboard, create a new waitlist, and copy your waitlist slug.

Step 2 — Embed the widget

Paste this anywhere in your HTML:

<script
  src="https://henry-warplist.vercel.app/widget.js"
  data-slug="your-waitlist-slug"
></script>
Step 3 — You're done

The widget automatically renders a signup form. Users can join and complete social actions to climb the queue.

Widget Options

<script
  src="https://henry-warplist.vercel.app/widget.js"
  data-slug="your-slug"
></script>

<!-- Or use a pre-created container: -->
<div id="warplist-widget"></div>
<script src="https://henry-warplist.vercel.app/widget.js" data-slug="your-slug"></script>

API Reference

POST/api/v1/waitlists/:id/subscribe
GET/api/v1/waitlists/:id/subscribers
GET/api/v1/waitlists/:id/stats
POST/api/verify/tweet
POST/api/verify/github-follow
POST/api/verify/x-follow
GET/api/v1/subscribers/:id/status

How Verification Works

Tweet Verification

Users share a pre-filled tweet and paste the URL. We verify via vxtwitter API that:

  • The tweet exists and is public
  • The tweet text contains your waitlist slug

GitHub Follow Verification

We call the real GitHub API:

GET https://api.github.com/users/{handle}/following/{target}
// 204 = following ✓
// 404 = not following ✗

24-Hour Re-verification

All verified actions are re-checked every 24 hours via a Vercel cron job. Users who unfollow or delete their tweet automatically lose their points and drop in the queue.

MCP Integration

WarpList exposes a Model Context Protocol (MCP) endpoint for AI agent integrations.

POST https://henry-warplist.vercel.app/api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "params": {},
  "id": 1
}