Skip to navigation

Request a sign-up code

View as Markdown

Sends a one-time code to the given email and returns a verificationId to complete sign-up. No authentication required. While new signups are paused, a new email is refused with 403 unless it carries a valid coupon.

Request

This endpoint expects an object.
emailstringRequiredformat: "email"

The address to send the code to. Addresses that reach the same mailbox are treated as one account: a +tag is dropped from the local part, dots are ignored in a gmail.com local part, and googlemail.com is read as gmail.com. So dev.user+dial@gmail.com signs in to the account owned by devuser@gmail.com rather than creating a second one, and the account is created under that canonical address.

couponstringOptional

An event coupon code (case-insensitive). On a new email it is checked before anything else: a valid code gets the signup past a signup pause, and its credit is added to the account when the account is created (at verify-number), once per email. A code that isn’t valid, isn’t active, or was already used by this email refuses the signup and no code is sent. Ignored when the email already has an account (signing in).

Response

Code sent.
verificationIdstringOptional
couponobjectOptional

Present when a coupon was given and accepted for a new account.

Errors

400
Bad Request Error
403
Forbidden Error
409
Conflict Error