Create a User
POST/docuflow/Users
Idempotent upsert — if a user with the same email already exists, they are updated instead of created. If the existing user is INACTIVE, the upsert also reactivates them. Still returns 201 in both cases. On upsert, displayName is preserved from the existing user record. Exactly one role per user is required for Digital Assets Management. Visitor-downgrade (demoting a non-Visitor to Visitor) only fires when POST upserts an existing non-Visitor user — pure-create payloads cannot trigger it. On production, a successful POST may send a first-access email; users created via this API are SSO-only and cannot log in with username/password. There is no SCIM-side API to check delivery or re-send it — use the Digital Assets Management product UI for re-sends. A POST without at least one role returns 400 (the error message contains the word "role"); the request has no effect and no first-access email is sent.
Request
Responses
- 201
- 400
- 401
- 403
- 500
User created
Invalid request (e.g. missing required fields, zero roles — exactly one role required, multiple roles assigned — exactly one role per user is required for Digital Assets Management, or visitor-downgrade attempt — cannot demote a non-Visitor user to Visitor)
Missing or invalid Bearer token
Tenant is not configured for this product
Internal server error — if this persists, contact your Inspectorio representative.