Versions Compared

Old Version 2

changes.mady.by.user Christian Holm

Saved on

compared with

New Version Current

changes.mady.by.user Christian Holm

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Endpoint

Method

/scim/Users

POST

...

Code Block
{
    "externalId": "<unique-identifier-in-source-system>",
    "userName": "<unique-email>",
    "active": <true|false>,
    "name": {
        "familyName": "<lastname>",
        "givenName": "<firstname>"
    },
    "roles": [
        {
            "value": "<talentech-group-identifier>"
       
},
        {
            "value": "<talentech-group-identifier>"
        }        
    ]
}


Property

Type

Required

externalId

string

Yes

Id of entity in remote system.
Must be unique pr integration.

2 users with same externalid cannot exist at the same time for the same integration

userName

string

Yes

Username for user.
Must be an email.

Must be unique pr integration

active

boolean
Valid values: true | false

No

Activationstatus for account.
Defaults to false if not set

name.familyName

string

No

Lastname

name.givenName

string

No

Firstname

roles

array

No

Should contain atleast 1 role in order to propegate provisioning of the user to applications



Sample-Request:

Code Block
curl --location --request POST 'https://[API-URL]/scim/Users' \
--header 'Authorization: Bearer [AUTH-TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "externalId": "16861ac5-deaa-4d66-a4cc-bc788965cc37",
    "userName": "username@domain.com",
    "active": true,
    "name": {
        "familyName": "Doe",
        "givenName": "John"
    },
    "roles": [
   
    {
            "value": "TalentechGroupTest1"
        },
        {
            "value": "TalentechGroupTest2"
        }        
    ]
}'


Responses:

User registered

Statuscode

201

Response-body: The generated User

Sample-response:

Code Block
{
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {},
    "active": true,
    "meta": {
        "resourceType": "User"
    },
    "name": {
        "familyName": "Doe",
        "givenName": "John"
    },
    "roles": [
        {
            "value": "TalentechGroupTest1",
            "type": null,
            "primary": false
        },
        {
            "value": "TalentechGroupTest2",
            "type": null,
            "primary": false
        }
    ],
    "userName": "username@domain.com",
    "externalId": "26861ac5-deaa-4d66-a4cc-bc788965cc37",
    "id": "a3792aca-8f99-4d4b-a1f2-2b31e871b634",
    "schemas": []
}


...