# Notification groups

A notification group selects a user's notifications by the module and the event they came from. A module and event pair is a group condition. The operations list groups, create a group with its first condition, rename and delete it, add and remove conditions.

**Scope:** `im` | **Base URL:** `https://vibecode.bitrix24.com/v1` | **Authorization:** `X-Api-Key`

## Operations

- [List notification groups](./groups/list.md) — `GET /v1/notifications/groups`
- [Create a notification group](./groups/create.md) — `POST /v1/notifications/groups`
- [Rename a notification group](./groups/update.md) — `PATCH /v1/notifications/groups/:groupId`
- [Delete a notification group](./groups/delete.md) — `DELETE /v1/notifications/groups/:groupId`
- [Add a condition to a notification group](./groups/conditions-create.md) — `POST /v1/notifications/groups/:groupId/conditions`
- [Remove a condition from a notification group](./groups/conditions-delete.md) — `DELETE /v1/notifications/groups/:groupId/conditions`

## Whose groups

Groups belong to the user on whose behalf the call is made. With a personal key, this is the key owner; with an OAuth application key, it is the session user from the `Authorization: Bearer` header. Only a group the user created can be renamed, deleted or have its conditions changed — in the group list it has `isEditable: true`.

## See also

- [Notifications](/docs/notifications)
- [Notification settings](/docs/notifications/settings)
- [Notification feed](/docs/notifications/list)