# Create a group

> Create a client group through the Quenza API, with an optional group chat and automatic sending of earlier activities to new members.

Source: https://quenza.com/help/api/groups/create-a-group/

Creates the group with the professional who owns the API token as its professional. Then [add clients to it](https://quenza.com/help/api/groups/add-members-to-a-group/).

- `enable_chat` creates a group chat for the group's clients.
- `auto_send_assignments_to_new_members` sends the group's earlier activities and programs to clients who join later. See [New group members](https://quenza.com/help/clients/new-group-members/).

Store the returned `id`: the API cannot list groups, and you need it to add members.

## Request

`POST https://developers.quenza.com/v1/groups`

### Request body

- `name` (string, required): Name of the group. Up to 255 characters
- `description` (string, or null): Short description of the group, or `null`. Up to 255 characters
- `enable_chat` (boolean, or null): Create a group chat for the group’s clients. Defaults to `false`.
- `auto_send_assignments_to_new_members` (boolean, or null): Send the group’s earlier activities and programs to clients who join later. Defaults to `false`.

### Example

```bash
curl -X POST https://developers.quenza.com/v1/groups \
  -H "Authorization: Bearer $QUENZA_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mindfulness group",
    "description": "Eight weekly sessions on attention, breathing and self-compassion.",
    "enable_chat": true,
    "auto_send_assignments_to_new_members": true
  }'
```

## Response

201 Created.

### Fields of data

- `id` (string): The group’s ID. Use it to add members.
- `name` (string): Name of the group.
- `description` (string, or null): Short description, or `null`.
- `picture` (string, or null): Address of the group picture, or `null`.
- `auto_send_assignments_to_new_members` (boolean): Whether clients who join later get the group’s earlier activities and programs.
- `file_collection_id` (string): ID of the folder that holds the group’s resources.
- `is_chat_enabled` (boolean): Whether the group has a group chat that is switched on.
- `status` (string): `active`, or `archived` after the group was archived. One of `active`, `archived`
- `archived_at` (string, or null): When it was archived, or `null`. ISO 8601 date and time in UTC
- `created_at` (string): When it was created. ISO 8601 date and time in UTC
- `updated_at` (string): When it was last changed. ISO 8601 date and time in UTC

```json
{
  "data": {
    "id": "R4XN8VQT",
    "name": "Mindfulness group",
    "description": "Eight weekly sessions on attention, breathing and self-compassion.",
    "picture": null,
    "auto_send_assignments_to_new_members": true,
    "file_collection_id": "6f1c2d8e-3b7a-4c55-9e21-8a4f0b2d7c19",
    "is_chat_enabled": true,
    "status": "active",
    "archived_at": null,
    "created_at": "2026-11-15T10:05:00.000000Z",
    "updated_at": "2026-11-15T10:05:00.000000Z"
  }
}
```

Status codes: 201 Created, 401 Unauthenticated, 402 Workspace not active, 403 Not on your plan, 406 Not acceptable, 415 Wrong content type, 422 Validation error. See /help/api/errors/.
