Method: addGroup

Permissions to Run the Request

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

Parameters

Parameter	Type	Description
credentials (required)	credentials	Read the description of the Credentials object.
name (required)	string	The name of the new group.
userId (optional)	string	The ID of a user.

Return Value

Parameter	Type	Description
groupId	string	The ID of the created group.

Possible Errors

Error	Description
Permission denied	The user has no permissions to add groups.
Wrong parameters	The system failed to process the request because it did not contain all necessary parameters.

Sample Call

<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
      <AddGroupRequest>
         <credentials>
          <accountUrl>https://myaccount.ispringlearn.com</accountUrl>
          <email>email@email.com</email>
          <password>password</password>
         </credentials>
        <name>NEW_GROUP</name>
        <userIds>
          <id>cfe9248a-deb4-11e9-979c-0a580af40764</id>
          <id>d030ff3a-deb4-11e9-b26a-0a580af40764</id>
          <id>d07ba5f8-deb4-11e9-a6de-0a580af40764</id>
        </userIds>
      </AddGroupRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CODE

Sample Response

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
    <AddGroupResult>
      <groupId>string</groupId>
    </AddGroupResult>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CODE