---
title: "Создать коннектор Битрикс24"
method: POST
path: "/v1/integrations/bitrix24/connectors"
tags: ["Integrations"]
---

# Создать коннектор Битрикс24

`POST /v1/integrations/bitrix24/connectors`

## Request

- Base URL: `https://api.hubris.pw`
- URL: `https://api.hubris.pw/v1/integrations/bitrix24/connectors`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hubris.pw/oauth/authorize`, token URL `https://api.hubris.pw/oauth/token`, scopes: `chat:write`)

Коннектор подключает модель Hubris к CoPilot (BitrixGPT) портала Битрикс24 как собственный движок. Под коннектор выпускается отдельный API-ключ «Битрикс24 · <имя>»: расход по нему виден отдельно, отзыв ключа выключает коннектор.

`completions_url` из ответа передайте порталу в `ai.engine.register`. Адрес содержит секрет и показывается один раз.

Модель закрепляется за коннектором; нужна другая — создайте второй коннектор. Сам вызов ничего не списывает, но требует права тратить: выпущенный ключ тратит баланс аккаунта.

## Request body

- Bitrix24ConnectorCreateRequest
  - `name` string, required: Имя подключения: видно в кабинете и в имени выпущенного ключа «Битрикс24 · <имя>».
  - `model` string, required: Полный ID модели каталога. Битрикс24 модель не передаёт, она закрепляется за коннектором.
  - `limit_kopecks` integer: Дневной лимит расхода выпущенного ключа, копейки.

## Response `201`

Коннектор создан.

- Bitrix24ConnectorCreated
  - `id` string, uuid, required
  - `completions_url` string, uri, required: Адрес для `completions_url` при регистрации движка в Битрикс24 (`ai.engine.register`). Содержит секрет и показывается один раз.
  - `model` string, required
  - `key_prefix` string, required: Маскированный префикс выпущенного ключа.

## Other responses

- `400`: Невалидное тело. Ответ — результат проверки схемы (`success: false`, `error.issues`), а не `{ error: { message, type, code } }`.
- `401`: Ключ не передан, невалиден, отозван или заморожен (`invalid_api_key`, `key_frozen_spike`).
- `403`: Нет права `chat:write`: ключ только для чтения (`key_read_only`) или OAuth-токен без него (`insufficient_scope`). Ещё причины: management-ключ (`inference_key_required`), запрос не с адреса, к которому привязан ключ (`key_ip_not_allowed`), или заблокированный аккаунт (`account_blocked`).
- `404`: Модель не найдена (`model_not_found`).
- `429`: Исчерпан лимит расхода ключа, которым сделан запрос (`daily_limit_exceeded`, `key_limit_exceeded`).
- `503`: Коннекторы временно недоступны (`bitrix24_unavailable`).

---

[API](https://skmtc.dev/hubris/apis/hubris-api.md) · [All operations](https://skmtc.dev/hubris/apis/hubris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hubris/apis/hubris-api/revisions/79ea91ed8f10?raw)