Skip to main content

Create User

Create a new user in the organization.

Quick Navigation
Outline

Endpoint​

POST /api/v1/users

Headers​

HeaderRequiredDescription
AuthorizationYesBearer <access_token>
Content-TypeYesapplication/json

Request Body​

{
  "email": "newuser@example.com",
  "display_name": "New User",
  "password": "SecurePassword123!",
  "organization_id": 1,
  "role_id": 2
}

Response​

Success (201)​

{
  "success": true,
  "data": {
    "user": {
      "id": 124,
      "email": "newuser@example.com",
      "display_name": "New User"
    },
    "message": "User created successfully"
  },
  "message": "User created successfully"
}

Features​

  • User creation with validation
  • Email verification setup
  • Default role assignment
  • Audit logging

Status​

[WARNING] TODO: Not Implemented

This endpoint is defined in the router but the implementation logic is not yet complete.