Create User

POST 
/Users

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 for SCIM resource creation.

Request

Responses

201

User created