POST /api/auth/register

Create a new user account using email and password.

This endpoint creates a new user account using an email and password.

It performs validation, hashes the password securely, and stores the user in the configured database.

When to use

HTTP

POST /api/auth/register
Content-Type: application/json

Request Body

{
  "email": "user@example.com",
  "password": "strong-password"
}

Field	Type	Required	Description
email	string	Yes	User’s email address
password	string	Yes	User’s password (hashed server-side)

Response

{
  "success": true,
  "data": {
    "id": "user_id",
    "email": "user@example.com"
  }
}

The password is never returned in the response.

Error

{
  "success": false,
  "message": "User already exists"
}

Error

{
  "success": false,
  "message": "Email and password are required"
}