Skip to main content
POST /api/v1/register No authentication required. Creates the user, creates an initial organization with the caller as owner, and generates an email verification token. The verification token is sent out-of-band (email delivery); the endpoint returns only the created user object.

Request body

name
string
required
Display name for the new user.
username
string
required
Email address used to log in. Must be in valid email format and must be unique.
password
string
required
Account password.

Response

user
object
required
The newly created user.

Errors

StatusWhen
400Request body is invalid or missing required fields
409An account with this email already exists

Example

curl -X POST http://localhost:8080/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Onur Kacmaz",
    "username": "[email protected]",
    "password": "mypassword123"
  }'
{
  "user": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Onur Kacmaz",
    "email": "[email protected]",
    "role": "admin",
    "email_verified_at": null,
    "created_at": "2026-03-21T10:00:00Z",
    "updated_at": "2026-03-21T10:00:00Z"
  }
}

Build docs developers (and LLMs) love