---
title: "POST /users"
method: POST
path: "/users"
tags: ["user"]
---

# POST /users

`POST /users`

Create a New user

## Request body

- CreateUserStruct
  - `department` string, required
  - `email` string, required
  - `firstname` string
  - `guid` string, required — should be a unique value representing user
  - `lastname` string, required
  - `partid` integer, required
  - `password` string, required
  - `usergroup` string, required
  - `username` string, required

## Response `201`

UserCreateSuccessResponse

- UserCreateSuccessResponse
  - `data` string
  - `message` string

## Other responses

- `400` — FailureResponse

## Changes

- **2021-10-13** `ee397eaefd08` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-10-09** `a5730259529b` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-10-08** `d39f8246865f` — 7 info
  - the endpoint scheme security `SecurityDefinitions` was added to the API
  - the endpoint scheme security `in` was added to the API
  - the endpoint scheme security `name` was added to the API
  - the endpoint scheme security `type` was added to the API
  - …3 more
- **2020-04-01** `8739183b4c43` — 1 info
  - api operation id `CreateUser` removed and replaced with `userCreateUser`
- **2020-01-30** `799e4fd8f4f4` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/sipcapture/apis/homer-app/changes/users/post.md)

---

[API](https://skmtc.dev/sipcapture/apis/homer-app.md) · [All operations](https://skmtc.dev/sipcapture/apis/homer-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipcapture/homer-app/revisions/ee397eaefd08/schema)