POST/Groups

Adds a new group. For properties you can specify when adding a group, see Property mapping.

A group is added as an internal group.
A group is added with the message room and mailing list features deactivated.
This API operation adds only members and group members of the group type. It cannot add group members of the team type.

To update those properties, you need to update the group information in the LINE WORKS service or use the LINE WORKS APIs.

Caution

  • For the same group, the following API operations must be called in the order they are listed: Add a group, Update a group, Update part of a group, and Delete a group.

HTTP Request

POSThttps://www.worksapis.com/scim/v2/Groups

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}

See Get a Long-Lived Token for SCIM.


required 
Content-Type string 

application/json


required 

Request Body

PropertyTypeDescription
schemas array (string) 

Schema URL


required 
externalId string 

ID managed by the SCIM client

 
displayName string 

Group name

It is not case-sensitive and must be unique within a domain.


required
maxLength : 100 
members array (ScimGroupMember) 

List of group members

 

ScimGroupMember

PropertyTypeDescription
value string 

Group member ID (member ID or group ID)


required 

Response

HTTP 201

PropertyTypeDescription
schemas array (string) 

Schema URL

 
id string 

Group ID

 
externalId string 

ID managed by the SCIM client

 
displayName string 

Group name

 
members array (ScimGroupMember) 

List of group members

 
meta object (meta) 
 

ScimGroupMember

PropertyTypeDescription
value string 

Group member ID (member ID or group ID)


required 
type string 

Group member type


Allowed values : USER, GROUP
readOnly : true 
display string 

Group member name (member name or group name)


readOnly : true 
$ref string 

Reference URL

Gets the detailed information of a group member.


readOnly : true 

meta

PropertyTypeDescription
resourceType string 

Resource type


Allowed values : USER, GROUP 
created string 

Creation date

 
lastModified string 

Last update date

 
location string 

Resource URI

 

HTTP 400

Bad Request

HTTP 409

Conflict