Versions Compared

Key

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


Endpoint

Method

/scim/Groups

POST

 

Request-object:

Code Block
{
  "externalId":"<unique-identifier-in-source-system>",
  "displayName": "<unique-group-name>",
}

Property

Type

Required

 

externalId

string

Yes

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

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

displayname

string

Yes

Name of group.
Must be unique pr integration



Sample-Request:

Code Block
curl --location --request POST 'https://[API-URL]/Scim/Groups' \
--header 'Authorization: Bearer [AUTH-TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
  "externalId":"d3895e27-8a8f-4864-8605-67d1dc828ef3",
  "displayName": "Group1DisplayName5"
}'


Responses:

Group created

Statuscode

201

Response-body: The created group

Sample-response:

Code Block
{
    "meta": {
        "resourceType": "Group"
    },
    "displayName": "Group1DisplayName5",
    "externalId": "c9f1b0f6-2519-44ad-8325-58329757208d",
    "id": "e90bcf88-0855-4473-b2b1-f64e13b7f391",
    "schemas": []
}

 

 

Conflict

Statuscode

409

Response-body: Error-details

Sample-response:

Code Block
{
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.8",
    "title": "Conflict",
    "status": 409,
    "traceId": "00-2b173cd7732a264a9e6c0923774c695a-a3015397652caa47-00"
}