---
title: "Create User"
method: POST
path: "/users"
tags: ["Users"]
---

# Create User

`POST /users`

When creating and using the Manger or Reader Roles it is required to use either the Environment/EnvironmentID or EnvironmentGroupID/EnvironmentGroup to select environments associated to each role. If selecting Admin, System Integrator or User admin keep these fields null.

## Request body

- object
  - `Department` 'Sales' | 'Onboarding' | 'Service Desk/NOC' | 'Account Management/vCIO' | 'Finance' | 'Leadership' | 'Other'
  - `Email` string
  - `Username` string
  - `FirstName` string
  - `LastName` string
  - `Groups` object[]
    - `ID` integer
    - `Name` 'Admin' | 'Manager' | 'Reader' | 'System Integrator' | 'User Admin'
    - `EnvironmentID` integer, nullable
    - `EnvironmentGroupID` integer, nullable
    - `Environment` string, nullable
    - `EnvironmentGroup` string, nullable
  - `MfaFactorAuth` boolean
  - `ReceiveTechUpdates` boolean

## Response `200`

- Users[]
  - `EnvironmentName` string, nullable
  - `ID` integer
  - `Environment` unknown
  - `FirstName` string
  - `LastName` string
  - `Email` string
  - `Username` string
  - `MfaFactorAuth` boolean
  - `Status` 'active' | 'invited'
  - `Owner` boolean
  - `Visible` boolean
  - `Locked` boolean
  - `LastLogin` string, date-time
  - `ReceiveTechUpdates` boolean
  - `Department` 'Sales' | 'Onboarding' | 'Service Desk/NOC' | 'Account Management/vCIO' | 'Finance' | 'Leadership' | 'Other'
  - `CreatedOn` string, date-time
  - `UpdatedOn` string, date-time
  - `Preferences` object
    - `ColorTheme` object, nullable
      - `name` string
      - `colors` object
      - `cssClass` string
  - `Groups` object[]
    - `ID` integer
    - `Name` string
    - `EnvironmentID` integer, nullable
    - `EnvironmentName` string, nullable
    - `EnvironmentGroupID` integer, nullable
    - `EnvironmentGroupName` string, nullable
  - `CreatedBy` object
    - `ID` integer
    - `FirstName` string
    - `LastName` string
    - `Username` string
  - `UpdatedBy` object
    - `ID` integer
    - `FirstName` string
    - `LastName` string
    - `Username` string

---

[API](https://skmtc.net/liongard/apis/liongard-v2-endpoints.md) · [All operations](https://skmtc.net/liongard/apis/liongard-v2-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liongard/liongard-v2-endpoints/versions/4ba1aeff82d7/schema)