ApiUsers
Create a new user (Admin only)
POST
Creates a new user with email, first name, last name, and password. Password must be at least 8 characters with uppercase, lowercase, number, and special character. Requires Admin role.
bearerX-API-Version?stringAPI version for header-based versioning
Default
"1"Value in
"1""2"application/json- body
email*stringUser email address
firstName*stringUser first name
Length
2 <= length <= 50lastName*stringUser last name
Length
2 <= length <= 50password?stringUser password (optional - temporary password generated if not provided)
Length
8 <= length <= 100User has been successfully created.
response?unknownapplication/jsoncurl -X POST 'http://localhost:3001/api/v1/users' \ -H 'Content-Type: application/json' \ -d '{ "email": "john.doe@example.com", "firstName": "John", "lastName": "Doe"}'Example Response
{ "status": "success", "statusCode": 201, "message": "User created successfully", "data": { "id": "6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe", "email": "john.doe@example.com", "firstName": "John", "lastName": "Doe", "isActive": true, "createdAt": "2026-01-27T10:23:22.983Z", "updatedAt": "2026-01-27T10:23:22.983Z" }, "meta": { "user_id": "6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe", "created_at": "2026-01-27T10:23:22.983Z" }, "timestamp": "2026-01-27T10:23:22.997Z", "path": "/api/v1/users"}