Повний доступ до ваших даних через API
Ліди, клієнти, угоди, продукти, задачі — все доступно через REST API. Інтегруйте TurboCRM з вашим сайтом, 1С, ERP або будь-якою системою за хвилини.
# Створити лід з вашого сайту за 1 запит
curl -X POST https://acme.turbocrm.app/api/v1/leads \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Марія Іванова",
"phone": "+380671234567",
"source": "website_form"
}'
# Response 201
{ "status": "ok", "lead_id": "01HXYZ..." }REST + JSON
Стандартний REST API з JSON. Працює з будь-якою мовою.
Bearer Token
API-ключі з правами доступу. Створюйте скільки потрібно.
Webhooks
Отримуйте події в реальному часі через вихідні вебхуки.
Rate limits
60 — 5000 req/min залежно від тарифу. Без обмежень на Business.
Ендпоінти API v1
Базовий URL: https://{tenant}.turbocrm.app/api/v1
/leadsСтворити лід. Обов'язкові поля: name, phone або email.
/leadsСписок лідів з фільтрами: ?source=, ?status=, ?assigned_to=, ?q=
/leads/{id}Деталі конкретного ліда
/leads/{id}Оновити поля ліда (часткове оновлення)
/leads/{id}Видалити лід
Приклад: створення ліда
curl -X POST https://acme.turbocrm.app/api/v1/leads \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"name":"Марія","phone":"+380671234567","source":"website_form"}'/clientsСписок клієнтів. Фільтри: ?type=company|person, ?tag=, ?q=
/clients/{id}Картка клієнта з контактами та тегами
/clientsСтворити клієнта
/clients/{id}Оновити клієнта
/clients/{id}Видалити клієнта
/dealsСписок угод. Фільтри: ?pipeline_id=, ?stage_id=, ?assigned_to=, ?status=
/dealsСтворити угоду
/deals/{id}Оновити угоду (етап, суму, менеджера тощо)
/deals/{id}/itemsСклад угоди — список позицій
/deals/{id}/itemsДодати позицію в угоду
/deals/{id}/items/{itemId}Оновити кількість, знижку, ціну позиції
/deals/{id}/items/{itemId}Видалити позицію з угоди
/productsСписок. Фільтри: ?category=, ?active=true, ?q=пошук
/products/{id}Одна позиція каталога
/productsСтворити. Поля: sku, name*, price*, unit, category, description, active
/products/{id}Оновити позицію
/products/{id}Видалити (soft delete якщо є в угодах)
/products/importМасовий імпорт CSV (multipart/form-data). SKU = ключ: нові створюються, існуючі оновлюються.
/products/exportЕкспорт прайсу CSV. Підтримує ті ж фільтри, що й GET /products.
Приклад: масовий імпорт прайсу
curl -X POST https://acme.turbocrm.app/api/v1/products/import \
-H "Authorization: Bearer sk_live_..." \
-F "file=@price.csv"
# CSV header: sku,name,price,unit,category,description,active
# Response: {"status":"ok","created":12,"updated":3,"skipped":0}/tasksСписок задач. Фільтри: ?assigned_to=, ?status=, ?type=call|meeting|email
/tasksСтворити задачу
/tasks/{id}Оновити задачу
/tasks/{id}/completeПозначити як виконану
Налаштуйте URL у Налаштування → Інтеграції → Webhooks. TurboCRM надсилатиме POST-запити при виникненні подій.
lead.created— новий лідlead.converted— лід конвертований в угодуdeal.created— нова угодаdeal.stage_changed— зміна етапу угодиdeal.won / deal.lost— виграш/програшdeal.items_changed— зміна складу позиційproduct.created / product.updated— зміни в каталозіproduct.imported— завершення bulk CSV-імпортуclient.created / client.updated— зміни клієнтівtask.created / task.completed— задачі/pipelinesСписок воронок з етапами
/pipelines/{id}/stagesЕтапи конкретної воронки
/usersСписок користувачів тенанта
/users/meПоточний авторизований користувач
Автентифікація
API-ключ (Bearer Token)
Кожен запит потребує заголовок Authorization.
Authorization: Bearer sk_live_abc123...Створіть ключ у Налаштування → API-ключі. Ключ показується один раз при створенні.
Rate Limits
Заголовки відповіді: X-RateLimit-Remaining, X-RateLimit-Reset
Готові інтегруватися?
Зареєструйтесь, отримайте API-ключ і надсилайте першу заявку за 5 хвилин.
Почати безкоштовно