---
schema_version: "1"
id: 097792431d8b861cdb25d7f52d09a97f6877a4cb9f2f907ec4b0bc987a7fecf4
title: "Example: Create Users with SCIM"
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/identity_scim_create_users.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.identity_scim_create_users.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 2f11abd0e4c96afb90ad93a14fc06cca01b4803692b5e1d81b4af279ce822acf
description: To create a user object with SCIM, send a POST request to the Users endpoint.
products:
  - Security
  - Cross Cloud
release: "264"
---
# Example: Create Users with SCIM

To create a user object with SCIM, send a POST request to the Users endpoint.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Salesforce Classic and Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>All</strong> Editions</td></tr></tbody></table>

When you create a user object, include all required fields in your request. For a list of required fields, see the User object in the [Object Reference](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_user.htm).

Here’s an example of creating a user object.

Request:

```
POST https://mycompany.my.salesforce.com/services/scim/v2/Users/

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "externalId": "scimUser",
  "userName": "scimUser@mycompany.com",
  "name": {
    "familyName": "Scim",
    "givenName": "User"
  },
  "emails": [
    {
      "type": "work",
      "primary": "true",
      "value": "user@mycompany.com"
    }
  ],
  "entitlements": [
    {
      "value": "profile_id"
    }
  ]
}
```

Response:

```
HTTP/1.1 201 Created
...

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
  ],
  "id": "005RM000002FZAlYAO",
  "userName": "scimuser@mycompany.com",
  "externalId": "scimUser",
  "name": {
    "formatted": "User Scim",
    "familyName": "Scim",
    "givenName": "User"
  },
  "displayName": "User Scim",
  "nickName": "scimUser@mycompany.com",
  "emails": [
    {
      "type": "work",
      "primary": true,
      "value": "user@mycompany.com"
    }
  ],
  "photos": [
    {
      "type": "photo",
      "value": "https://mycompany.file.force.com/profilephoto/005/F"
    },
    {
      "type": "thumbnail",
      "value": "https://mycompany.file.force.com/profilephoto/005/T"
    }
  ],
  "userType": "Standard",
  "preferredLanguage": "en_US",
  "emailEncodingKey": "UTF-8",
  "locale": "en_US",
  "timezone": "America/Los_Angeles",
  "active": true,
  "entitlements": [
    {
      "value": "00eRM000001VtbnYAC",
      "$ref": "/Entitlements/00eRM000001VtbnYAC",
      "display": "System Administrator",
      "type": "Profile",
      "primary": true
    }
  ],
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "organization": "00DRM000000HOcw2AG"
  },
  "urn:salesforce:schemas:extension:2.0": {
    "alias": "45512346"
  },
  "meta": {
    "created": "2020-10-19T10:11:52Z",
    "lastModified": "2020-10-19T16:11:52Z",
    "location": "https://mycompany.my.salesforce.com/services/scim/v2/Users/005RM0...",
    "resourceType": "User",
    "version": "f63f4831a8747d4bd0de70fcca991553be4b2e01"
  }
}
```

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-identity-264-0-0-production-enus/699dab6f-8f1a-4662-b24f-6521d5b747f7/images/icon_note.png)

Note When you create or update users with SCIM, you can assign only one phone number to each user.