Initiate signup (create/resume activation + email OTP)

Step 1 of self-service signup. Creates a new SignupActivation for the email (or resumes an in-progress one), optionally tagging it with a plan and referral code, and emails a one-time verification code (OTP, category rs_signup, 5-minute expiry). Rejects an email that already has a registered User. Side effect: sends an OTP email.

Auth

  • Public — no bearer token (auth: noauth). Route lives in the public login/signup throttle group.

Rate limit

  • 10 requests/min per IP. Public route.

Body

FieldTypeRequiredNotes
emailstringRequiredValid email (rfc,dns); must not already be registered 403.
term_and_conditionintegerRequiredMust be 1 (terms accepted).
plan_idintegerOptionalMust be an existing plan; stored on the activation.
company_industry_idintegerOptionalMust be an existing industry.
referral_codestringOptionalReferral / partner code; ties the signup to a partner or account company.
query_stringstringOptionalRaw marketing query string (e.g. UTM params) kept for attribution.

Behaviour

  • Synchronous. 200 returns the activation snapshot (data.account, plus data.business / data.feature_options / data.meta_data once later steps run, and data.user once a User exists).
  • 403 when the email already has a registered account.
  • 400 when the activation is already Active (You have already registered.).
  • 422 on validation failure.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
integer
integer
string
string
Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json