POST /groups

Creates a new group for the target company.

Group names must be unique within the scope of a company so this operation fails if a group with the given name already exist.

curl -XPOST \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer 4a415cc660e67d8f4d26d5a7f390183a86fc3a4524ded78dc2448e86c48b2739" \ --data '{ "name": "new group name" }'

This request will return, for example, the following JSON response:

  "id": "234123543",
  "name": "new group name"



Response body


Attribute Type Description
id string An unique identifier of this group
name string The name of the group


This endpoint may return the following errors

HTTP Code Description
401 Unauthorized Invalid credentials were supplied
422 Unprocessable Entity A group with the given name already exists