# Create User

`POST /Users`

## Description

Provisions a new user in your Roam organization.

**Required fields:** `userName`, `name.givenName`, `name.familyName`, and `emails[0].value`.

**Roam-specific behavior:**
- `userName` must exactly match the primary email address
- `displayName` is auto-generated from givenName + familyName (any provided value is ignored)
- Email/userName becomes **immutable** after creation
- Use the `urn:ro.am:params:scim:schemas:extension:roam:2.0:User` extension to set `role` ("User" or "Admin")

See [RFC 7644 §3.3](https://www.rfc-editor.org/rfc/rfc7644#section-3.3) for SCIM resource creation.

## Request Body

## Responses

### 201 - User created

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/scim/01-users-create*