Skip to main content

Register User

Register a new user account.

Endpoint

POST /api/Authentication/register

Request Body

{
"email": "[email protected]",
"password": "SecurePassword123!",
"fullName": "John Doe",
"username": "johndoe"
}

Parameters

ParameterTypeRequiredDescription
emailstringYesUser email address
passwordstringYesPassword (min 8 characters)
fullNamestringYesUser's full name
usernamestringYesUnique username

Response

Success (201 Created)

{
"success": true,
"data": {
"userId": "user-id-here",
"email": "[email protected]",
"fullName": "John Doe",
"username": "johndoe",
"token": "eyJhbGciOiJIUzI1NiIs...",
"refreshToken": "refresh-token-here"
}
}

Error (400 Bad Request)

{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Email already exists"
}
}

Example

const response = await fetch('http://localhost:5000/api/Authentication/register', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
password: 'SecurePassword123!',
fullName: 'John Doe',
username: 'johndoe'
})
});

const data = await response.json();

Validation Rules

  • Email must be valid and unique
  • Password must be at least 8 characters
  • Username must be unique and alphanumeric
  • Full name is required

Next Steps