Create User

Creates a new user in the system.

Endpoint

POST /v1/users

Authentication

Requires a valid Bearer token with createUser action permission.

Authorization: Bearer {access_token}

Request Body

{
  "email": "user@example.com",
  "firstName": "Jane",
  "lastName": "Doe",
  "userType": "internal"
}

| Field | Type | Required | Description | |-------|------|----------|-------------| | email | string | Yes | User's email address (must be unique) | | firstName | string | Yes | User's first name | | lastName | string | Yes | User's last name | | userType | "internal" \| "external" | Yes | Type of user |

Response

201 Created

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "email": "user@example.com",
  "firstName": "Jane",
  "lastName": "Doe",
  "userType": "internal",
  "createdAt": "2025-01-15T10:30:00Z"
}

400 Bad Request

{
  "error": "VALIDATION_ERROR",
  "message": "Email is already in use"
}

403 Forbidden

{
  "error": "FORBIDDEN",
  "message": "You do not have permission to create users"
}