[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-notifications":3,"docs-tabs-notifications":6},{"content":4,"lastmod":5},"# Уведомления\n\nОтправка уведомлений сотрудникам Битрикс24: личные и системные уведомления, отметка о прочтении и удаление по идентификатору или метке. Уведомления приходят в раздел «Уведомления» портала.\n\n**Скоуп:** `im` | **Базовый URL:** `https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1` | **Авторизация:** `X-Api-Key`\n\n[Быстрый старт](#быстрый-старт) | [Полный пример](#полный-пример) | [Справочник эндпоинтов](#справочник-эндпоинтов) | [Коды ошибок](#коды-ошибок)\n\n## Быстрый старт\n\nОтправьте уведомление сотруднику по его `userId`:\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fnotifications\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"userId\": 1, \"message\": \"Сделка №1024 перешла в стадию «Оплачено»\" }'\n```\n\nОтвет (HTTP 201):\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"notificationId\": 37421\n  }\n}\n```\n\n## Полный пример\n\nОтправить уведомление, отметить его прочитанным и удалить:\n\n```javascript\nconst BASE = 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1'\nconst headers = {\n  'X-Api-Key': 'YOUR_API_KEY',\n  'Content-Type': 'application\u002Fjson',\n}\n\n\u002F\u002F 1. Отправить\nconst sendRes = await fetch(`${BASE}\u002Fnotifications`, {\n  method: 'POST',\n  headers,\n  body: JSON.stringify({ userId: 1, message: 'Сделка №1024 перешла в стадию «Оплачено»' }),\n})\nconst { data } = await sendRes.json()\nconst id = data.notificationId\n\n\u002F\u002F 2. Отметить прочитанным\nawait fetch(`${BASE}\u002Fnotifications\u002Fread`, {\n  method: 'POST',\n  headers,\n  body: JSON.stringify({ id, onlyCurrent: true }),\n})\n\n\u002F\u002F 3. Удалить\nconst delRes = await fetch(`${BASE}\u002Fnotifications\u002F${id}`, {\n  method: 'DELETE',\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconsole.log('Удалено:', delRes.status === 204)\n```\n\n## Справочник эндпоинтов\n\n| Метод | Путь | Bitrix24 метод | Описание |\n|-------|------|----------------|----------|\n| POST | [\u002Fv1\u002Fnotifications](\u002Fdocs\u002Fnotifications\u002Fsend) | im.notify.personal.add | Отправить уведомление сотруднику |\n| POST | [\u002Fv1\u002Fnotifications\u002Fread](\u002Fdocs\u002Fnotifications\u002Fread) | im.notify.read | Отметить уведомления прочитанными |\n| DELETE | [\u002Fv1\u002Fnotifications\u002F:id](\u002Fdocs\u002Fnotifications\u002Fdelete) | im.notify.delete | Удалить уведомление по идентификатору |\n| DELETE | [\u002Fv1\u002Fnotifications\u002Fby-tag\u002F:tag](\u002Fdocs\u002Fnotifications\u002Fdelete-by-tag) | im.notify.delete | Удалить уведомления по метке (только OAuth-приложение) |\n\nИнтерактивный переключатель методов с примерами и полями ответа — [Эндпоинты](\u002Fdocs\u002Fnotifications\u002Fendpoints).\n\n## Коды ошибок\n\n| HTTP | Код | Описание |\n|------|-----|----------|\n| 400 | `MISSING_PARAMS` | При отправке не передан `userId` или `message` |\n| 422 | `NOTIFICATION_NOT_DELIVERED` | Получателя нет на портале или он деактивирован |\n| 403 | `BITRIX_ACCESS_DENIED` | Удаление по метке вызвано личным ключом вместо ключа OAuth-приложения |\n| 403 | `SCOPE_DENIED` | У ключа нет скоупа `im` |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | Ключ в режиме «только чтение» |\n| 401 | `TOKEN_MISSING` | У ключа нет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Отправить уведомление](\u002Fdocs\u002Fnotifications\u002Fsend)\n- [Сотрудники](\u002Fdocs\u002Fentities\u002Fusers)\n- [Чаты](\u002Fdocs\u002Fchats)\n- [Ошибки](\u002Fdocs\u002Ferrors)\n","2026-07-07",{}]