LeadsService

RegisterInterest

RegisterInterest adds an email to the Pro waitlist and sends a confirmation email. Turnstile-gated (desktop sources authenticate a bypass with a shared-secret HMAC instead). A failed Cloudflare Turnstile check returns 403 Bot verification failed; a desktop-source request with a missing or invalid HMAC signature returns 403 Desktop authentication failed.

post/api/leads/v1/register-interest

Request

  • Base URL: https://api.worldmonitor.app
  • URL: https://api.worldmonitor.app/api/leads/v1/register-interest
  • Auth: none required

Headers

Idempotency-Keystring

Optional client-generated idempotency key. Retrying a POST with the same key and an identical request body replays the original response (only the status, body, and Content-Type are reproduced) instead of re-executing; reusing the key with a different body is rejected with 422. For mutations this avoids duplicating the side effect, while for batch-read POSTs it replays a cached snapshot that can be up to 24 hours stale. Keys are scoped per authenticated caller (falling back to the source IP for unauthenticated endpoints) and retained for 24 hours.

Request body

emailstring required
sourcestring
appVersionstring
referredBystring
websitestring

Honeypot — bots auto-fill this hidden field; real submissions leave it empty.

turnstileTokenstring required

Cloudflare Turnstile token. Desktop sources bypass Turnstile; see handler.

Response

OK

statusstring

"registered" for a new signup; "already_registered" for a returning email.

referralCodestring

Stable referral code for this email.

referralCountinteger

Number of signups credited to this email.

positioninteger

Waitlist position at registration time. Present only when status == "registered".

emailSuppressedboolean

True when the email is on the suppression list (prior bounce) and no confirmation was sent.

Changes

No recorded changes to this operation across all 1 revision of this API.