# Add members to a group

> Add one or more clients to a Quenza group through the API. They join the group chat and can get the activities the group already received.

Source: https://quenza.com/help/api/groups/add-members-to-a-group/

Send the IDs of the clients in `members`. For each client who is not in the group yet:

- They join the group's chat, if it has one.
- When the group sends earlier activities and programs to new members, they get them now.

Clients who are already in the group, and IDs that match no client, are skipped. If nobody new was added, the answer is `204` without a body. That makes the request safe to repeat, for example when your shop sends a payment notification twice.

[Add buyers to a group](https://quenza.com/help/api/guides/add-buyers-to-a-group/) shows the whole flow from purchase to group.

## Request

`POST https://developers.quenza.com/v1/groups/{group}/members`

### Path parameters

- `group` (string, required): The group’s ID.

### Request body

- `members` (array of strings, required): IDs of the clients to add. Clients who are already in the group, and IDs that match no client, are skipped.

### Example

```bash
curl -X POST https://developers.quenza.com/v1/groups/R4XN8VQT/members \
  -H "Authorization: Bearer $QUENZA_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "members": [
      "8GJ4D9KQ",
      "2M7ZP5AT"
    ]
  }'
```

## Response

200 OK.

### 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:06:00.000000Z"
  }
}
```

Status codes: 200 OK, 204 No content, 401 Unauthenticated, 402 Workspace not active, 403 Not on your plan, 404 Not found, 406 Not acceptable, 415 Wrong content type, 422 Validation error. See /help/api/errors/.
