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

# Create User

`POST /scim/v2/Users`

Creates a new user

## Request body

- ScimUser
  - `active` boolean — User status
  - `addresses` ScimUserAddress[]
    - `country` string
    - `locality` string
    - `postalCode` string
    - `region` string
    - `streetAddress` string
    - `type` 'work', required
  - `emails` ScimEmail[], required
    - `type` 'work', required
    - `value` string, required
  - `externalId` string — External unique resource ID defined by provisioning client
  - `id` string — Unique resource ID defined by RingCentral
  - `name` ScimName, required
    - `familyName` string, required
    - `givenName` string, required
  - `phoneNumbers` ScimPhoneNumber[]
    - `type` 'work' | 'mobile' | 'other', required
    - `value` string, required
  - `photos` ScimPhoto[]
    - `type` 'photo', required
    - `value` string, required
  - `schemas` string[], required
  - `title` string — User title
  - `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User` ScimEnterpriseUser
    - `department` string
  - `userName` string, required — MUST be same as work type email address

## Response `201`

Successful response

- ScimUserResponse
  - `active` boolean — User status
  - `addresses` ScimUserAddress[]
    - `country` string
    - `locality` string
    - `postalCode` string
    - `region` string
    - `streetAddress` string
    - `type` 'work', required
  - `emails` ScimEmail[], required
    - `type` 'work', required
    - `value` string, required
  - `externalId` string — External unique resource ID defined by provisioning client
  - `id` string — Unique resource ID defined by RingCentral
  - `name` ScimName, required
    - `familyName` string, required
    - `givenName` string, required
  - `phoneNumbers` ScimPhoneNumber[]
    - `type` 'work' | 'mobile' | 'other', required
    - `value` string, required
  - `photos` ScimPhoto[]
    - `type` 'photo', required
    - `value` string, required
  - `schemas` string[], required
  - `title` string — User title
  - `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User` ScimEnterpriseUser
    - `department` string
  - `userName` string, required — MUST be same as work type email address
  - `meta` ScimMeta — Resource metadata
    - `created` string, date-time
    - `lastModified` string, date-time
    - `location` string — Resource location URI
    - `resourceType` 'User' | 'Group' | 'ResourceType' | 'Schema'

## Other responses

- `400` — Bad request
- `401` — Authorization failure
- `403` — Permissions denied
- `404` — Not found
- `409` — Duplicate email
- `429` — Too many requests
- `500` — Internal server error

---

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