Minctrl Docs

Register a user and auto-create their company

POST
/auth/register

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