Provision a SCIM enterprise user

POST

/scim/v2/enterprises/{enterprise}/Users

Note: The SCIM API endpoints for enterprise accounts are currently in private beta and are subject to change.

Creates an external identity for a new SCIM enterprise user.

SCIM does not authenticate users, it only provisions them. The authentication of users is done by SAML. However, when SCIM is enabled, all users need to be provisioned through SCIM before a user can sign in through SAML. The matching of a user to a SCIM provisioned user is done when the SAML assertion is consumed. The user will be matched on SAML response NameID to SCIM userName.

When converting existing enterprise to use SCIM, the user handle (userName) from the SCIM payload will be used to match the provisioned user to an already existing user in the enterprise. Since the new identity record is created for newly provisioned users the matching for those records is done using a user's handle. Currently the matching will be performed to all of the users no matter if they were SAML JIT provisioned or created as local users.

リクエストパラメータ

パスパラメータ

リクエストボディパラメータapplication/json

例

レスポンス

🟢201Created

application/scim+json

User has been created

ボディapplication/scim+json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠409409

🟠429429

🔴500Server Error

リクエストExample

Shell

JavaScript

Java

Swift

cURL

UserEnterprise Owner

curl --location 'https://service1.exmaple.com/scim/v2/enterprises//Users' \
--header 'Content-Type: application/json' \
--data-raw '{
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "externalId": "E012345",
    "active": true,
    "userName": "E012345",
    "name": {
        "formatted": "Ms. Mona Lisa Octocat",
        "familyName": "Octocat",
        "givenName": "Mona",
        "middleName": "Lisa"
    },
    "displayName": "Mona Lisa",
    "emails": [
        {
            "value": "mlisa@example.com",
            "type": "work",
            "primary": true
        }
    ],
    "roles": [
        {
            "value": "User",
            "primary": false
        }
    ]
}'

レスポンスExample

201 - 例 1

{}

更新日時 2025-06-12 06:47:18

List SCIM provisioned identities for an enterprise

Get SCIM provisioning information for an enterprise user