Skip to main content

Create User

POST /v1/user

Creates a new user in the system. This endpoint validates the provided input, applies default settings, assigns the user to the specified tenant, and returns the created user object with metadata and identifiers.

Request Body​

{
      "firstname": "test",
      "lastname": "test",
      "username": "test@example.com",
      "role": "user"
  }

Response Example​

{
  "firstname": "Test",
  "lastname": "User",
  "username": "user@example.com",
  "factors": [
    {
      "type": "mail",
      "value": "user@example.com",
      "_id": "factor-id-1"
    }
  ],
  "role": "user",
  "tenant": "tenant-id-1",
  "status": {
    "active": true
  },
  "type": "user",
  "_id": "user-id-1",
  "created": "2025-10-29T10:07:36.446Z",
  "updated": "2025-10-29T10:07:36.446Z",
  "__v": 0,
  "id": "user-id-1"
}