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

# Create a user

`POST /users`

## Request body

- UserAPIModifyUser
  - `email` string, required — The email address of the user
  - `familyName` string, required — The family/last name of the user
  - `givenName` string, required — The given/first name of the user
  - `role` UserAPIRole, required
    - `id` string — The id of the role. Note: id should be excluded if name is provided during a modify operation
    - `name` string — The name of the role. Note: name should be excluded if id is provided during a modify operation

## Response `200`

OK response.

- UserAPIUser
  - `createdAt` string
  - `email` string, required — The email address of the user
  - `enabled` boolean, required — Whether the user is active or deactivated
  - `familyName` string, required — The family/last name of the user
  - `givenName` string, required — The given/first name of the user
  - `id` string — ID of the user
  - `lastLoggedInAt` string
  - `role` UserAPIRole, required
    - `id` string — The id of the role. Note: id should be excluded if name is provided during a modify operation
    - `name` string — The name of the role. Note: name should be excluded if id is provided during a modify operation
  - `status` string — The Cognito auth-related status of this User

## Other responses

- `400` — bad_request: Bad Request response.

---

[API](https://skmtc.dev/panther/apis/panther-rest-api.md) · [All operations](https://skmtc.dev/panther/apis/panther-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/panther/panther-rest-api/revisions/eb177cb9d6a1/schema)