Register a new user

Developing

POST

/auth/register

Creates a new user account in the system using the provided registration details such as name, email address, and password. After successful registration, the system generates a verification code and sends it to the user’s email address to confirm ownership. The account typically remains in a pending or unverified state until the email verification process is completed.

Request

Body Params application/jsonRequired

Examples

Responses

🟢201User Created

application/json

Body

🟠400Validation Error

🟠409Email Already Exists

🟠429Rate Limit Exceeded

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://localhost:3000/api/v1/auth/register' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Willard Lueilwitz",
    "email": "taryn82@hotmail.com",
    "password": "DLCO2lz$Pj@RSpg"
}'

Response Example

201 - Example

{
    "status": "success",
    "message": "User created successfully.",
    "data": {
        "id": "cc9ed1b3-0051-4dc6-907a-67080bd8ddd1",
        "name": "Bob Klocko",
        "email": "makayla.paucek99@gmail.com",
        "email_verified": false,
        "email_verified_at": "2026-03-02T03:10:05+00:00",
        "created_at": "2026-03-02T03:10:05+00:00",
        "updated_at": "2026-03-02T03:10:05+00:00"
    }
}

Modified at 2026-03-07 02:24:42

Authentication

Verify email address