CRM-формы

Формы принимают данные посетителей и могут создавать лиды. Этот раздел позволяет агенту узнать состав формы, не меняя её настройки.

Битрикс24 API: crm.form.list, crm.form.get

Скоуп: crm

Список CRM-форм

GET /v1/crm-forms вызывает crm.form.list. Нужны ключ API Вайбкод и скоуп crm; ключ READONLY подходит.

Параметр	Значение
active	Необязательное true/false или 1/0. Без параметра Битрикс24 возвращает только активные формы.
isCallback	Необязательное true/false или 1/0.

Ответ содержит массив data из объектов { id, name } и meta.total. Порядок — ID по убыванию, пагинации нет. Например, GET /v1/crm-forms?active=false ищет неактивные формы.

Битрикс24 без права просмотра форм молча отдаёт пустой список. data: [] само по себе не доказывает, что форм нет.

Ошибки: 400 UNKNOWN_FILTER_FIELD для неизвестного параметра, 400 INVALID_PARAMS для неверного или повторённого булева фильтра, 403 SCOPE_DENIED, 422 BITRIX_ERROR для отказа Битрикс24. Общие ошибки ключа, квоты и доступности описаны в Ошибках.