Sign Up

Create a new user account and receive a JWT token.

POST /api/auth/signup

No authentication required.

Request body

name · string · required

The user’s display name.

email · string · required

The user’s email address. Must be unique across all accounts.

password · string · required

The user’s password. Minimum 6 characters.

Example

cURL

curl --request POST \
  --url http://localhost:3000/api/auth/signup \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Maria Silva",
    "email": "[e-mail]",
    "password": "s3cr3tpass"
  }'

Response

201 Created

token · string · required

A signed JWT valid for 30 days. Include this token in the Authorization header for authenticated requests.

user · object · required

Hide properties

id · string

Unique identifier for the user.

name · string

The user’s display name.

email · string

The user’s email address.

points · number

Total habit points accumulated. Starts at 0.

current_streak · number

Current consecutive days with at least one completed habit. Starts at 0.

max_streak · number

All-time highest streak. Starts at 0.

Example response

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": "a3f2c1d0-89b4-4e7a-b6f5-1234567890ab",
    "name": "Maria Silva",
    "email": "[e-mail]",
    "points": 0,
    "current_streak": 0,
    "max_streak": 0
  }
}

Errors

Status	Description
400	Email is already in use, or request body fails validation.
500	Internal server error.