Add an email to the waitlist

POST

/v1/waitlist/signups

Adds a new signup to the project’s waitlist and returns the user’s queue position and a referral code to share.

Auth: Publishable key (nv_pub_live_*) — call this directly from browser JavaScript. No backend proxy required.

CORS: Access-Control-Allow-Origin: * — safe to call from any frontend origin.

Returns 409 with DUPLICATE_SIGNUP if the email already exists.

Authorizations

• PublishableApiKey
• SecretApiKey

Request Body ^required

object

email

required

string format: email

<= 254 characters /^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/

referrer_code

string

/^[A-Za-z0-9]{8}$/

metadata

object

key

additional properties

Any of:

string

string

number

number

boolean

boolean

source

object

referrer

string

<= 2048 characters

utm_source

string

<= 255 characters

utm_medium

string

<= 255 characters

utm_campaign

string

<= 255 characters

landing_path

string

<= 512 characters

turnstile_token

string

Responses

201

Signup created

object

data

required

object

signup_id

required

string

/^ws_[0-9A-HJKMNP-TV-Z]{26}$/

position

required

integer

> 0 <= 9007199254740991

referral_code

required

string

/^[A-Za-z0-9]{8}$/

referral_link

required

string format: uri

referrer_credited

required

boolean

confirmation_email_sent

required

boolean

already_registered

required

boolean

project_plan

required

string

Allowed values: free indie builder

error

required

null

meta

object

key

additional properties

401

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties

409

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties