Adding a Group

You can add a group by sending the POST request to the following URL: /group.

Request Headers

Parameter Description
X-Auth-Account-Url (required) Base URL of the account, e.g.
X-Auth-Email (required) Administrator/Publisher e-mail address.
X-Auth-Password (required) Administrator/Publisher password.
X-Name (required) A name of the new group.
X-Description (optional) A description of the new group.

After the request has been completed, the system returns the response with Code 201. The body of the response contains ID of the added group.

Possible Response Codes

Code Text Description
400 Bad Request The system failed to process the request, because it did not contain all necessary parameters.
403 Duplicated group name A group with the specified name already exists.
201 Created A new group has been added.

Sample Request

POST /group HTTP/1.1
X-Auth-Password: password
X-Name: New group
X-Description: description

Sample Response

HTTP/1.1 201 Created
Server: nginx
Connection: close