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" \
https://api.invisiblecollector.com/groups --data '{ "name": "new group name" }'
This request will return, for example, the following JSON response:
{
"id": "234123543",
"name": "new group name"
}
Endpoint
POST https://api.invisiblecollector.com/groups
Response body
Group
Attribute | Type | Description |
---|---|---|
id | string | An unique identifier of this group |
name | string | The name of the group |
Errors
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 |