ДелоВед Получить демо
Для разработчиков

API приёма заявок

Редакция от 23.09.2026

Заявка, отправленная в этот API, становится сделкой в воронке продаж компании. Воронку, источник и ответственного выбирают правила, которые администратор компании настраивает в CRM (Настройки → Формы сайта). Так же работают интеграции через Albato и формы на Тильде.

Ключ

У каждой компании свой ключ. Он в CRM: Настройки → Формы сайта, кнопка «Копировать» даёт ссылку вида https://api.delovedcrm.ru/api/v1/webforms/<ключ>; ключ — её часть после /webforms/. Передаётся заголовком:

Authorization: Bearer <ключ>

Вместо заголовка ключ можно поставить в конец адреса: https://api.delovedcrm.ru/api/v1/webforms/<ключ>.

Проверка ключа

GET https://api.delovedcrm.ru/api/v1/webforms
Authorization: Bearer <ключ>

200 {"result": "ok", "company": "Название компании"}

Создать заявку

POST https://api.delovedcrm.ru/api/v1/webforms
Authorization: Bearer <ключ>
Content-Type: application/json

{
  "name": "Иван Петров",
  "phone": "+7 913 123-45-67",
  "email": "ivan@example.ru",
  "formname": "VK: банкротство",
  "tranid": "vk-123456",
  "comment": "Долг 800 тыс., 3 кредитора"
}

200 {"result": "ok", "lead_id": 1882}
Поле Что это
phoneтелефон в любом виде, приводится к +7…
nameимя, становится названием сделки; нет имени — сделка называется телефоном
emailпочта
formnameназвание формы или кампании; по нему правила выбирают воронку и источник
tranidid заявки в источнике; повтор с тем же id второй сделки не заводит
любое другоеответы формы; ложатся текстом в ленту сделки

Тело — плоский JSON или обычная форма (application/x-www-form-urlencoded).

Ответы

  • 200 — заявка принята. Даже если сделку собрать не удалось, заявка сохраняется в журнале «Форм сайта» и не теряется.
  • 401 — ключа нет или он неверный.
  • 403 — доступ компании приостановлен.
  • 429 — больше 120 запросов в минуту.

Поддержка

hello@delovedcrm.ru