API документация · /bitrix24/rest · 2 622 документа

Битрикс24 REST API: Методы, вебхуки и примеры кода

CRM и смарт-процессы, задачи, чаты и чат-боты, телефония, каталог и магазин, входящие и исходящие вебхуки, OAuth 2.0, события, batch и лимиты. Ищите на сайте или подключите MCP-сервер к Claude Code и Cursor — каждый ответ со ссылкой на apidocs.bitrix24.ru.

Искать в Битрикс24 REST API Подключить MCP

Попробуйте найти

Паспорт источника

Service ID: /bitrix24/rest
Источник: apidocs.bitrix24.ru — официальная документация
Документов: 2 622
Состав: 2622 страницы · 2392 в справочнике API · 230 руководств и SDK
Проверка источника: 31.07.2026
Версия API: не подтверждена

apidocs.bitrix24.ru/index.html

Битрикс24 REST API — один из 17 API в Bridge8. Тот же поиск и MCP-сервер работают для VK, Яндекса, Битрикс24, Авито и других:

Весь каталог: 25 источников →

Что включено

2 622 документа Битрикс24 REST API в одном поиске

Сохранённые копии apidocs.bitrix24.ru. У каждого документа — ссылка на официальную страницу и дата импорта.

CRM
652
Лиды, сделки, контакты и компании, универсальные методы crm.item.*, смарт-процессы, товарные позиции и события CRM.
- crm.item.add · crm.item.list
- Смарт-процессы: crm.type.list
- События CRM
Задачи, совместная работа и бизнес-процессы
479
Задачи, группы и проекты, Диск, оргструктура, календарь, бизнес-процессы и роботы, учёт рабочего времени, списки, пользователи.
- tasks.task.add
- user.get
- bizproc.robot.add
Торговля
399
Торговый каталог и товары, заказы магазина, платёжные системы.
- catalog.product.add
- sale.order.add
- Платёжные системы
Коммуникации и телефония
358
Чаты и сообщения, чат-боты, открытые линии, внешняя телефония, почта, СМС-провайдеры и провайдеры сообщений.
- im.message.add
- telephony.externalCall.register
- Чат-боты
Платформа: доступ, авторизация, вызов методов
106
Доступ к REST API, вебхуки, OAuth 2.0, локальные приложения, события, batch и списочные методы, скоупы, лимиты и коды ошибок.
- Входящие и исходящие вебхуки
- OAuth 2.0
- event.bind · batch
Прочее: справочник, туториалы, SDK, Маркет
628
Сайты, виджеты и встройки, онлайн-запись, генератор документов, BI-коннектор, REST 3.0, туториалы, SDK, тиражные приложения, AI-инструменты.
- Обзор REST API 3.0
- placement.bind
- MCP-сервер для AI

С чего начать

Как создать входящий вебхук в Битрикс24: пять шагов по документации

Коротко по официальным страницам «Как выполнить свой первый запрос к API» и «Входящие и исходящие вебхуки». Подробности — в поиске Bridge8 или у вашего ИИ-агента.

Проверьте доступ к REST APIНужна подписка Маркетплейс на платном тарифе или пробный режим — его включают в виджете «Мой тариф».
Откройте раздел разработчика«Приложения» → «Разработчикам» → вкладка «Готовые сценарии» → «Другое» → «Входящий вебхук». Код вебхука генерируется сразу.
Настройте праваВ блоке «Настройка прав» выберите скоупы. Запросы выполняются с правами пользователя, который создал вебхук.
Проверьте запросВ генераторе запросов выберите метод, укажите параметры и нажмите «Выполнить» — ответ придёт в формате JSON.
Вызывайте из своей системыURL вида https://<портал>/rest/<ID пользователя>/<секретный код>/<метод>.json. Код держите в секрете и не встраивайте в публичный код.

Доступ к REST API

Постоянный: подписка Маркетплейс на платном тарифе
Пробный: демо-режим в «Мой тариф»
Для технологических партнёров: NFR-ключ

API не расширяет права: через него можно делать только то, что пользователь может сделать в интерфейсе. В коробочной версии пробный период Маркетплейса доступен только при активной лицензии.

apidocs.bitrix24.ru/first-steps/access-to-rest-api.html

Вебхук или OAuth 2.0

Вебхук — для внутренних сценариев одного портала. Для приложений, которые будут работать у разных пользователей, и для решений в Маркетплейс нужен OAuth 2.0.

Документация

Частые задачи: методы и руководства

Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу apidocs.bitrix24.ru.

Методы REST API

7 из 2 392

Все 2 392 страницы справочника API в поиске

Руководства

7 из 230

Все 230 страниц руководств в поиске

Как использовать

Три способа работать с документацией Битрикс24 REST API

Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.

01 · На сайте
Поиск без регистрации
Выберите Битрикс24 REST API в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на apidocs.bitrix24.ru.
Битрикс24 REST API · 2 622 → входящий вебхук
02 · ИИ-агент по MCP
Спросите Claude Code или Cursor
Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.
«Напиши на PHP выгрузку всех сделок Битрикс24 через входящий вебхук методом crm.item.list с постраничной загрузкой. Сверь методы с apidocs.bitrix24.ru»
resolve_service → search_docs → get_document
03 · Документ целиком
Читайте страницу полностью
get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.
get_document → crm.item.list

Пример ответа · crm.item.list

Битрикс24 REST API /bitrix24/rest

crm.item.list

Получает список элементов определённого типа объекта CRM. Элементы не попадут в выборку, если у пользователя нет прав на их чтение. Тип объекта задаётся числом: Лид — 1, Сделка — 2, Контакт — 3, Компания — 4, Счёт — 31.

Параметры

entityTypeIdinteger: Обязательный. Идентификатор системного или пользовательского типа, чьи элементы нужно получить.
selectarray: Список полей, которые должны быть заполнены у элементов в выборке.
filterobject: Условия отбора; по умолчанию соединяются через AND, для OR передают ключ logic.

apidocs.bitrix24.ru/api-reference/crm/universal/crm-item-list.html

Универсальные методы CRMверсия не подтверждена

Подключение

Подключите документацию Битрикс24 REST API к ИИ-агенту

Один MCP-сервер Bridge8 — и агент знает Битрикс24 REST API и ещё 16 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.

Как подключить за минуту

Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
Спросите про Битрикс24 REST API«Найди в Битрикс24 REST API, как получить все сделки через crm.item.list с постраничной загрузкой, и покажи ссылку на источник».

Получить токен

Только документация

Bridge8 не подключается к вашему порталу Битрикс24, не создаёт и не хранит вебхуки и токены, не меняет данные CRM. Агент получает документацию и сам пишет код.

Claude Code — команда

claude mcp add --transport http bridge8 \
  https://bridge8.ru/mcp \
  --header "Authorization: Bearer <TOKEN>"

JSON для --mcp-config

{
  "mcpServers": {
    "bridge8": {
      "type": "http",
      "url": "https://bridge8.ru/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

Инструменты сервера — в порядке вызова

resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
get_documentЧитает документ целиком, постранично, со ссылкой на источник.

Вопросы

Вопросы о Битрикс24 REST API

Как создать входящий вебхук?

В Битрикс24 откройте «Приложения» → «Разработчикам» → «Готовые сценарии» → «Другое» → «Входящий вебхук». Задайте права в блоке «Настройка прав» и проверьте метод в генераторе запросов. Вебхук создаёт только пользователь — сгенерировать его автоматически нельзя.

Чем входящий вебхук отличается от исходящего?

Входящий — ключ, с которым ваша система вызывает методы REST; срок его действия не ограничен. Исходящий работает наоборот: при выбранном событии Битрикс24 обращается к URL вашего обработчика и передаёт токен для проверки. В коробочной версии исходящему вебхуку нужна активная лицензия, на демо-порталах он не работает.

Вебхук или OAuth 2.0?

Вебхук прост, но у него нет срока действия: утечка URL даёт доступ к порталу в рамках его прав. Поэтому он подходит для внутренних интеграций, а не для тиражных решений; часть методов — встраивание в интерфейс, события телефонии — через вебхук недоступна. Приложениям для разных пользователей и Маркетплейса нужен OAuth 2.0.

Как создать сделку или контакт через API?

Универсальным методом crm.item.add: тип объекта задаёт entityTypeId — Лид — 1, Сделка — 2, Контакт — 3, Компания — 4, Счёт — 31; идентификатор смарт-процесса возвращает crm.type.list. Перед созданием проверяются права и обязательные поля, после сохранения запускаются роботы.

Как получить следующую страницу списочного метода?

Списочные методы возвращают элементы пакетами — сейчас не более чем по 50. Чтобы получить следующий пакет, повторите тот же запрос с параметром start, равным значению next из ответа.

Какие лимиты на частоту запросов?

Лимит работает по принципу Leaky Bucket. На тарифе «Энтерпрайз» счётчик уменьшается на 5 в секунду, блокировка — при 250; на прочих тарифах — 2 в секунду и 50. При превышении приходит 503 QUERY_LIMIT_EXCEEDED. За превышение лимита на ресурсоёмкость — 429 OPERATION_TIME_LIMIT, блокировка снимается через 10 минут.

Есть ли у Битрикс24 свой MCP-сервер?

Да. По документации, MCP-сервер Битрикс24 даёт ИИ-инструментам доступ к официальной REST-документации, работает по Streamable HTTP и доступен без авторизации. Bridge8 ищет по той же документации apidocs.bitrix24.ru и ещё по 16 API в одном MCP — у каждого фрагмента ссылка на источник.

Bridge8 может управлять моим порталом?

Нет. Bridge8 — документация для разработчиков: он не подключается к Битрикс24 от вашего имени, не создаёт вебхуки и приложения, не хранит токены и не меняет данные CRM. Версия REST API в Bridge8 не подтверждена: сверяйтесь с apidocs.bitrix24.ru.

Ещё в Bridge8

Один поиск и один MCP-сервер для 17 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.

Другие API в Bridge8

16 API · 3 136 документов

Яндекс

8 API

VK и MAX

3 API

CRM, телефония, банк

2 API

Объявления и рассылки

3 API

Справка и курсы

8 источников

Справка Яндекс Директа, Справка Яндекс Метрики, Справка Яндекс Вебмастера, Справка Яндекс Вордстата, Справка VK Рекламы, Справка Авито Рекламы, Курсы Яндекса (ЯРД), Курсы VK Рекламы.

Каталог на главной

← На главную: поиск по всем источникам bridge8.ru/#catalog