#Создать чат

POST /v1/bots/:botId/chats

Создаёт новый групповой чат от имени бота.

#Поля запроса (body)

Параметр Тип Обяз. Описание
fields.title string нет Название чата
fields.description string нет Описание чата
fields.color string нет Цвет чата (16 именованных цветов). Невалидные значения назначаются автоматически
fields.avatar string нет URL аватара чата
fields.userIds number[] нет Массив ID пользователей для добавления
fields.ownerId number нет ID владельца. Если не указан — владельцем становится бот
fields.message string нет Первое сообщение в чате

#Примеры

#curl — личный ключ

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/bots/42/chats \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "title": "Чат поддержки",
      "description": "Канал технической поддержки",
      "userIds": [1, 5, 12],
      "color": "AZURE"
    }
  }'

#curl — OAuth-приложение

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/bots/42/chats \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "title": "Чат поддержки",
      "description": "Канал технической поддержки",
      "userIds": [1, 5, 12],
      "color": "AZURE"
    }
  }'

#JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bots/42/chats', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    fields: {
      title: 'Чат поддержки',
      description: 'Канал технической поддержки',
      userIds: [1, 5, 12],
      color: 'AZURE',
    },
  }),
})

const { success, data } = await res.json()
console.log('Chat ID:', data.chatId)

#JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bots/42/chats', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    fields: {
      title: 'Чат поддержки',
      description: 'Канал технической поддержки',
      userIds: [1, 5, 12],
      color: 'AZURE',
    },
  }),
})

const { success, data } = await res.json()

#Поля ответа

Поле Тип Описание
chat.id number ID созданного чата
chat.dialogId string ID диалога (chatXXX)
chat.name string Название чата
chat.owner number ID владельца
chat.type string Тип чата
chat.color string Цвет чата
chat.dateCreate string Дата создания (ISO 8601)
chat.permissions object Права в чате
users array Массив участников чата

#Пример ответа

JSON 
{
  "success": true,
  "data": {
    "chat": {
      "id": 3555,
      "dialogId": "chat3555",
      "name": "Чат поддержки",
      "type": "chat",
      "owner": 42,
      "color": "#4ba984",
      "description": "",
      "dateCreate": "2026-04-13T17:12:03+03:00",
      "permissions": {
        "manageUsersAdd": "member",
        "manageUsersDelete": "manager",
        "manageSettings": "owner",
        "canPost": "member"
      }
    },
    "users": [
      {
        "id": 42,
        "name": "Техподдержка",
        "active": true,
        "bot": true
      }
    ]
  }
}

#Пример ответа при ошибке

404 — бот не найден:

JSON 
{
  "success": false,
  "error": {
    "code": "BOT_NOT_FOUND",
    "message": "Bot 999 not found. Register it first via POST /v1/bots."
  }
}

#Ошибки

HTTP Код Описание
400 INVALID_BOT_ID botId не является числом
404 BOT_NOT_FOUND Бот с таким ID не найден
403 BOT_ACCESS_DENIED Бот принадлежит другому API-ключу
502 BITRIX_ERROR Ошибка Bitrix24 при создании чата
403 SCOPE_DENIED API-ключ не имеет скоупа imbot
401 TOKEN_MISSING API-ключ не имеет настроенных токенов

Полный список общих ошибок API — Ошибки.

#Известные особенности

Владелец по умолчанию: если ownerId не указан, владельцем чата становится бот.

Невалидные цвета: если передать несуществующий цвет, Bitrix24 назначит цвет автоматически.

#Смотрите также