[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-chats\u002Fmanagement\u002Fcreate":3,"docs-tabs-chats\u002Fmanagement\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать групповой чат\n\n`POST \u002Fv1\u002Fchats`\n\nСоздаёт новый групповой чат на портале Битрикс24. Возвращает числовой ID созданного чата.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `title` | string | нет | Название чата |\n| `description` | string | нет | Описание чата |\n| `users` | array | нет | Массив числовых ID участников. Список: `GET \u002Fv1\u002Fusers` |\n| `type` | string | нет | Тип чата: `CHAT` (обычный) или `OPEN` (открытый). По умолчанию — `CHAT` |\n| `entityType` | string | нет | Тип связанной сущности (например, `CRM`) |\n| `entityId` | string | нет | Идентификатор связанной сущности (например, `DEAL\\|123`) |\n| `color` | string | нет | Цвет чата: `RED`, `GREEN`, `MINT`, `LIGHT_BLUE`, `DARK_BLUE`, `PURPLE`, `AQUA`, `PINK`, `LIME`, `BROWN`, `AZURE`, `KHAKI`, `SAND`, `MARENGO`, `GRAY`, `GRAPHITE` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"title\": \"Проект Альфа\",\n    \"users\": [27, 29],\n    \"type\": \"CHAT\",\n    \"color\": \"AZURE\"\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"title\": \"Проект Альфа\",\n    \"users\": [27, 29],\n    \"type\": \"CHAT\",\n    \"color\": \"AZURE\"\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    title: 'Проект Альфа',\n    users: [27, 29],\n    type: 'CHAT',\n    color: 'AZURE',\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('Chat ID:', data) \u002F\u002F числовой ID чата\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    title: 'Проект Альфа',\n    users: [27, 29],\n    type: 'CHAT',\n    color: 'AZURE',\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | number | Числовой ID созданного чата |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": 3663\n}\n```\n\n## Пример ответа при ошибке\n\n422 — Битрикс24 вернул ошибку при создании чата:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Access denied.\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку (текст в `message`) |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `im` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Поле `title` необязательно.** Чат создаётся и без названия — в этом случае имя формируется автоматически по именам участников. Поле рекомендуется передавать для групп с более чем двумя участниками.\n\n**Тип `OPEN`.** Открытый чат виден всем пользователям портала, которые знают его ID. Обычный чат (`CHAT`) доступен только приглашённым участникам.\n\n**Поле `data` — числовой ID чата.** Для последующих вызовов (`PATCH \u002Fv1\u002Fchats\u002F:chatId`, `POST \u002Fv1\u002Fchats\u002F:chatId\u002Fusers` и других) нужен именно числовой ID, не строка `chat\u003CN>`.\n\n## Смотрите также\n\n- [Управление чатами](\u002Fdocs\u002Fchats\u002Fmanagement)\n- [Передать владение](\u002Fdocs\u002Fchats\u002Fmanagement\u002Fowner)\n- [Добавить участников](\u002Fdocs\u002Fchats\u002Fmembers\u002Fadd)\n","2026-06-23",{}]