Create group
Use this endpoint to create a new groups based on templates configured for organisations in Seamless.
Properties
| Attribute | Type | Description |
|---|---|---|
displayName | string | The name of the group to be created. |
description | string/null | Optional description of the group. |
mailNickName | string | Unique alias for the group’s email address. |
responsible | string | Primary responsible person's user ID or email. |
deputy | string/null | Optional backup responsible person's user ID or email. |
organisationIdOrIdentifier | string | ID or unique identifier of the organization creating the group. |
templateIdOrIdentifier | string | ID or identifier of the policy template to be applied. |
owners | array[string] | List of user IDs or emails to be assigned as group owners. |
members | array[string] | List of user IDs or emails to be assigned as group members. |
Request
POST /teams
Content-Type: application/json
{
"displayName": "My test group 1",
"description": null,
"mailNickName": "mytest",
"responsible": "john.doe@contoso.com",
"deputy": null,
"organisationIdOrIdentifier": "cn",
"templateIdOrIdentifier": "cstprj",
"owners": [
"john.doe@contoso.com"
],
"members": [
"jane.smith@contoso.com",
"alex.taylor@contoso.com",
"maria.garcia@contoso.com",
"chris.jordan@contoso.com"
]
}Response
HTTP/1.1 200 OK
Content-type: application/json
{
"status": "…",
"teamId": "…",
"statusUrl": "…"
}