Creates a new empty group

Returns

Returns the new group object. This endpoint will create an empty group. You can use the Update an user or Create a new user endpoints to add users to the group by providing a Group Key. You can't assign a client and a user the same Group Key.

The following are the examples of HTTP status codes including errors that API can generate

Response codes

Response content

Description

200 OK

A group object

The group has been created successfully.

400 Bad Request

Clients is not available

You need the 'Clients' feature to be enabled for your account to create a group of type'Client'.

400 Bad Request

The Name cannot be empty

The field "Name" cannot be empty.

400 Bad Request

Invalid group type:"Incorrect Type"

The 'Type' parameter that was specified is invalid.

400 Bad Request

Attribute not found, Key=112

A team attribute wasn't found.

400 Bad Request

Seconds level is not available

You need the "SecondsLevel" feature to be enabled for your account.

Language
Authentication
Click Try It! to start a request and see the response here!