---
title: "Create a SCIM user"
method: POST
path: "/scim/v2/Users"
tags: ["scim"]
---

# Create a SCIM user

`POST /scim/v2/Users`

Provisions a new Ringover user (RFC 7644 §3.3).

**Behavior & limitations:**
- This is a **real onboarding**: an invitation is sent and a **license and phone number** are consumed from your team.
- A **valid email is required**: provide a primary `emails` value or an email-formatted `userName`, otherwise `400 invalidValue` is returned.
- `roles[].value` must be the **numeric profile id** (see `GET /profiles`); a non-numeric value is silently ignored.
- `externalId` is echoed back but **not persisted**.

## Response `201`

User created

## Other responses

- `400` — Invalid value (e.g. missing or invalid email)
- `401` — Authentication token is missing, invalid, or expired
- `409` — A user with this email already exists (uniqueness)

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)