---
title: "Create User"
method: POST
path: "/v1/users/"
tags: ["Teams", "users"]
---

# Create User

`POST /v1/users/`

Create a new user.

Requires team:write_user permission for the specified team (team owners and admins) or
team:write_user_all permission (super admin).

## Request body

- CreateUserRequest — Request model for creating a user with team assignment.
  - `email` string, email, required — User email address
  - `password` string, required — User password
  - `given_name` string, nullable — User's given name
  - `family_name` string, nullable — User's family name
  - `external_user_id` string, nullable — External user identifier
  - `profile_image` string, uri, nullable — URL to user's profile image
  - `team_id` string, uuid, required — ID of the team to assign the user to
  - `password_change_required` boolean — Whether the user must change their password on first login

## Response `201`

Successful Response

- UserRead — Returned to clients when reading user info.
  - `id` string, uuid, required
  - `email` string, email, required
  - `is_active` boolean
  - `is_superuser` boolean
  - `is_verified` boolean
  - `given_name` string, nullable
  - `family_name` string, nullable
  - `external_user_id` string, nullable
  - `profile_image` string, uri, nullable
  - `password_change_required` boolean
  - `is_super_admin` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/versions/a8b2ee2b2d06/schema)