---
title: "Create SCIM User"
method: POST
path: "/scim/Users"
tags: ["Scim", "User"]
---

# Create SCIM User

`POST /scim/Users`

Creates a new user. Used by SCIM clients like Okta to provision users.

## Request body

- CreateScimUserRequest
  - `schemas` string[], required
  - `userName` string, required
  - `emails` object[], required
    - `primary` boolean
    - `value` string
    - `type` string
  - `phoneNumbers` object[]
    - `value` string
    - `type` string
  - `name` object, required
    - `familyName` string
    - `givenName` string
  - `active` boolean, required
  - `password` string, required
  - `groups` object[]
    - `display` string
    - `value` string
  - `urn:okta:onprem_app:1.0:user:custom` object
    - `roleUUID` string

## Response `201`

User created successfully

- ScimUser
  - `id` string, required
  - `externalId` string, required
  - `meta` object, required
    - `created` string
    - `lastModified` string
    - `version` string
  - `schemas` string[], required
  - `userName` string, required
  - `displayName` string
  - `preferredLanguage` string
  - `locale` string
  - `timezone` string
  - `active` boolean, required
  - `emails` object[], required
    - `value` string
    - `type` string
    - `primary` boolean
  - `phoneNumbers` object[], required
    - `value` string
    - `type` string
  - `groups` object[]
    - `display` string
    - `value` string
  - `name` object, required
    - `familyName` string
    - `givenName` string
  - `urn:okta:onprem_app:1.0:user:custom` object, required
    - `roleUUID` string

## Other responses

- `401` — Valid API key required
- `500` — Unexpected server error. Please try again later.
- `default` — Unexpected error

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)