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

# Create a new user

`POST /users`

## Request body

- UserCreateRequest
  - `name` object, required
    - `firstName` string, required
    - `lastName` string, required
  - `email` string, email, required

## Response `201`

User created

- User
  - `_id` string — MongoDB ObjectId
  - `name` object
    - `firstName` string
    - `lastName` string
  - `email` string, email
  - `accessLevel` 'user' | 'admin' | 'superadmin'
  - `role` string
  - `createdDate` string, date-time
  - `currentRole` string
  - `desiredRole` string
  - `newMember` boolean
  - `currentJobTitle` string
  - `desiredJobTitle` string
  - `skillsToMatch` string[]
  - `firstAttended` string
  - `attendanceReason` string
  - `projects` string[]
  - `githubHandle` string
  - `phone` string
  - `textingOk` boolean
  - `slackName` string
  - `isHflaGithubMember` boolean
  - `githubPublic2FA` boolean
  - `availability` string
  - `managedProjects` string[]
  - `isActive` boolean

## Other responses

- `400` — Bad request
- `409` — Duplicate email

---

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