Register a user and auto-create their company
Register user + auto-create their company. Returns a JWT.
Public endpoint (no auth). On success returns {token, user, company}.
Open registration (the deployed mode, CLOSED_BETA_DISABLED=true): anyone may
sign up with any valid address — personal domains (gmail, outlook, …) included.
The whitelist is then consulted only to bootstrap platform admins.
Closed beta gate (2026-05-08): when enabled, every new email must be in
user_whitelist with status='approved' before a users row is
created. Unseen/pending emails are added to the waitlist and get a
{"status": "waitlisted", ...} response instead of a token. Only in this mode is
a personal-email domain refused; bootstrap admins (is_admin=TRUE in the
whitelist) bypass that block.
Notable statuses: 409 if the email is already registered, 422 for an invalid email (or, with the closed-beta gate on, a personal one), 403 if the email was rejected.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Sign-up payload — creates the user and auto-creates their company.
Response Body
application/json
curl -X POST "https://example.com/auth/register" \ -H "Content-Type: application/json" \ -d '{ "company_name": "Acme Health", "email": "[email protected]", "name": "Jane Doe", "password": "<your-password>" }'null