AVAILABLE WITH BUSINESS SUBSCRIPTION

Request: POST /group

Permissions to Run the Request

Account Owner, Account Administrators, Department Administrators, or custom roles

Request Headers

HeaderDescription
Authorization (required)Access token. You can obtain a token by making a request.
ParameterDescription
name (required)The name of the group.
userIds (optional)The IDs of the users who will be included in the group.

Response Codes

CodeTextDescription
201Creatednew group has been added. The body of the response contains ID of the added group.
400Bad RequestSome of the sent parameters are incorrect.
401UnauthorizedAn authorization error.
403Permission deniedThe user doesn't have enough permissions to add groups.

Sample Request

POST /group https/1.1
Host: api-learn.ispringlearn.com
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8"?>
<request>
    <name>New Hires</name>
    <userIds>
        <id>3fa85f64-5717-4562-b3fc-2c963f66afa6</id>
        <id>9265e422-deb9-11e9-b4d0-864db459a4d7</id>
    </userIds>
</request>
XML

Sample Response

https/1.1 201 Created


<?xml version="1.0" encoding="UTF-8"?>
<response>b1496214-acab-11e9-8db0-120a62f268a9</response>
XML