Create Group

Time	Status	User Agent
Retrieving recent requests…

Authorization

This endpoint requires Authorization.

Key	Type	Description	Required
name	string	Name of the group. Must be unique within the organization.	Yes
user_ids	array	List of user UUIDs to add to the group on creation. Users not in this organization are silently ignored.	No

{
  "name": "London Team",
  "user_ids": ["9e34b87d-79ca-4dc3-ac42-8ce9ebe8be82"]
}

Returns the created group including any initial members:

Key	Subkey	Type	Description
id		string	Unique identifier of the group (UUID).
name		string	Name of the group.
created_at		datetime	Timestamp when the group was created.
users		array	Users added to the group at creation.
	id	string	User UUID.
	name	string	User display name.
	email	string	User email address.

Status	Message	Description
422	Parameter name is required	The `name` field is missing.
422	Name has already been taken	A group with this name already exists.