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
}
]
}