---
title: "Create User"
description: "Creates a new user in the organization."
---

`POST /api/users`

## Request Body

```json
{
  "email": "jane@deinkunde.com",
  "firstName": "Jane",
  "lastName": "Doe",
  "role": "user", // "admin" or "user"
  "password": "temporaryPassword123", // Optional, user can set it later
  "customerIds": ["11111111-1111-4111-8111-111111111111", "22222222-2222-4222-8222-222222222222"] // Optional: Limit access to specific customers via public IDs
}
```

Notes:

- `customerIds` accepts customer public IDs and legacy numeric IDs.
- Public IDs are the preferred format for new integrations.

## Response

Returns the created user object. See [Error Codes](/api/error-codes-and-known-pitfalls) for error responses.