---
title: "Create a new user and add it to the customer"
method: POST
path: "/projects/{projectId}/customers/{customerId}/users"
tags: ["Users"]
---

# Create a new user and add it to the customer

`POST /projects/{projectId}/customers/{customerId}/users`

## Path parameters

- `projectId` string, required
- `customerId` string, required

## Request body

- object
  - `email` string, email, required — User's email address
  - `firstName` string, required — User's first name
  - `lastName` string, required — User's last name
  - `password` string — User's initial password.

## Response `201`

User created successfully

- User
  - `id` string, uuid — Unique identifier for the user
  - `email` string, email, required — User's email address
  - `firstName` string, required — User's first name
  - `lastName` string, required — User's last name
  - `emailVerified` boolean — Flag indicating whether the user's email address has been verified
  - `enabled` boolean, required — Flag indicating if the user account is active
  - `createdAt` string, date-time — Timestamp when the user was created

## Other responses

- `400` — Bad Request
- `401` — Authentication failed
- `403` — Forbidden
- `404` — Not Found
- `409` — The resource has dependents (e.g. children that inherit from it) and cannot be deleted.
- `500` — Internal server error
- `503` — External service unavailable

---

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