CLI

The Waitloop CLI is designed for LLMs and automation pipelines: every command prints a single JSON object to stdout, exit code 0 on success, 1 on failure (with {"ok": false, "error": ...}).

Setup

export WAITLOOP_API_KEY=wl_YOUR_KEY        # create at /dashboard/keys
export WAITLOOP_API_URL=https://waitloop.dev   # only needed for self-hosted instances

No install needed — run through npx waitloop-cli (or npm i -g waitloop-cli for a global waitloop command).

Commands

npx waitloop-cli me                             # who am I
npx waitloop-cli waitlists:list                 # all waitlists + signup counts
npx waitloop-cli waitlists:create --name "Acme Robots" \
  --headline "Robots for everyone" --accent "#ff6b3d" --background dark
npx waitloop-cli waitlists:get acme-robots      # by slug or UUID
npx waitloop-cli waitlists:update acme-robots --success "See you at launch."
npx waitloop-cli waitlists:delete acme-robots
npx waitloop-cli signups:list acme-robots --limit 50
npx waitloop-cli signups:add acme-robots --email friend@example.com
npx waitloop-cli stats acme-robots
npx waitloop-cli export acme-robots --format csv   # prints raw CSV

Create/update flags

Example output

{
  "ok": true,
  "waitlist": {
    "id": "0d9c…",
    "slug": "acme-robots",
    "name": "Acme Robots",
    "pageUrl": "https://waitloop.dev/w/acme-robots",
    "referralsEnabled": true
  }
}