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

# Create a new user

`POST /users`

Creates a new user with the given status. Use [login identifiers](/api-reference/backend-api/identifiers/create-a-login-identifier-for-a-user) to add an email address or phone number to the user.

You can also manage users in the [Developer Panel](https://app.corbado.com/users).

## Request body

- UserCreateReq
  - `fullName` string
  - `status` 'pending' | 'active' | 'disabled' | 'deleted', required
  - `explicitWebauthnID` string — For [Corbado Connect](https://docs.corbado.com/corbado-connect) projects, the webauthnID can be explicitly set for a user

## Response `200`

User has been created.

- User
  - `userID` string, required
  - `fullName` string
  - `status` 'pending' | 'active' | 'disabled' | 'deleted', required
  - `explicitWebauthnID` string
  - `updated` string, required
  - `updatedMs` integer, required

## Other responses

- `default` — Error

---

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