---
title: "Create User"
description: "Creates a new user. E-mail authentication is always enabled, and no password is set, meaning the only way to authenticate the newly created user is through magic link."
api: "POST /users"
---

## Request

The request body is required.

## Response

<ResponseField name="201" type="object">
  Successful response containing the created user.
</ResponseField>

<CodeGroup>
```bash cURL
curl -X POST "https://api.stack-auth.com/users" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"primary_email": "user@example.com", "display_name": "New User"}'
```
</CodeGroup>