Skip to main content

Example: Create Users with SCIM

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

Gregory Claeyssens avatar
Written by Gregory Claeyssens
Updated over a week ago

When you create a user object, include all required fields in your request. Here’s an example of creating a user object.

For a full overview, see the schema reference here and the documentation about our SCIM implementation here.

Request:

POST https://api.storychief.io/scim/v2/Users
Accept: application/scim+json
Content-Type: application/scim+json
Authorization: ••••••

{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User"
],
"userName": "jane.doe@example.com",
"externalId": "12345",
"name": {
"givenName": "Jane",
"familyName": "Doe"
},
"emails": [
{
"value": "jane.doe@example.com",
"type": "work",
"primary": true
}
],
"roles": [
{
"value": "admin"
}
],
"active": true
}

Response:

HTTP/1.1 201 Created

{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User"
],
"id": 1,
"meta": {
"created": "2025-06-23T11:02:15+02:00",
"lastModified": "2025-06-23T11:02:15+02:00",
"location": "https://api.storychief.io/scim/v2/Users/1",
"resourceType": "User",
"version": "W/\"a12a2ad8c90b51b343a9987230b372ee411e0275\""
},
"name": {
"familyName": "Doe",
"givenName": "Jane"
},
"userName": "jane.doe@example.com",
"emails": [
{
"value": "jane.doe@example.com",
"type": "work",
"primary": true
}
],
"roles": [
{
"value": "admin",
"display": "Publisher",
"type": "primary",
"primary": true
}
]
}

Did this answer your question?