HubSpot усунув одну з найнеприємніших проблем для розробників

Зміни у версіонуванні HubSpot API: перехід до передбачуваного календаря

HubSpot остаточно взявся за проблему нескоординованого версіонування своїх API, яка протягом багатьох років непокоїла розробників, що будують на платформі. Раніше система версіонування мала назви v1, v2, v3, v4, але вони були несумісні між різними API. Через короткі періоди відміни деяких версій інтеграцій та непередбачувані зміни, це створювало багато головного болю для розробників. Проте станом на березень 2026 року ситуація кардинально змінюється.

Переваги нової системи версіонування

Замість числового версіонування HubSpot переходить на формат /YYYY-MM/, що класно вирівнює оновлення API. Перший реліз нової системи /2026-03/ вже відбувся, і підтверджено, що нові версії будуть виходити щомаршу та щовересневого вересня. Кожна версія є незмінною: критичні зміни вводять лише у нові версії без втручання в уже існуючі. Це знижує ризики несподіваних змін для розробників, а кожна версія підтримуватиметься щонайменше 18 місяців.

Що змінюється для розробників?

Для тих, хто наразі працює з HubSpot API, усе впроваджено досить просто. Реліз /2026-03/ включає найновіші поверхні API на основі останніх кінцевих точок v3 та v4. Міграція вимагає лише зміни шляху в URL, наприклад, замінивши /crm/v3/ на /crm/objects/2026-03/. Застарілі версії, такі як /2025-09/, підтримуються до релізу /2027-03/. Водночас, deprecation v1 APIs вже має свій графік; наприклад, Contact Lists API v1 відходить у минуле 30 квітня 2026 року.

Розробники можуть значно полегшити собі життя, завдяки чітким відміткам: “Історично відповіді на основні питання щодо того, яку версію використовувати, коли відбудуться зміни, і як планувати оновлення, були важкодоступними. Версіонування на основі дати призначене для усунення цієї недоліки.”

Важливість періодичності релізів

Новий графік релізів – двічі на рік у березні та вересні, злагоджений із загальним календарем випусків HubSpot, – надає розробникам те, чого вони раніше не мали: передбачувана горизонт планування. До цього моменту вони змушені були постійно відстежувати оновлення changelog-ів та справлятися з критичними оновленнями лише за 90 днів. Тепер, завдяки 18-місячному вікну підтримки на кожну версію, команди можуть планувати оновлення з урахуванням їх власних циклів релізів, а не реакції на внутрішні графіки HubSpot.

Поява MCP сервера: розширені можливості для інтеграцій

В межах того ж релізу Spring Spotlight, HubSpot оголосив про загальну доступність сервера MCP, що дозволяє клієнтам, сумісним із MCP, підключатися до даних та флоу HubSpot. Наступний крок значно розширює можливості для розробників, адже додає можливості запису, історію взаємодії, маркетингові об’єкти контенту та контекст організації. Це особливо важливо для розробників, які будують AI-агентів або агентські флоу, оскільки означає, що тепер агенти можуть взаємодіяти з даними CRM HubSpot, використовуючи той самий стандарт протоколу.

Зміна на дату-засноване версіонування має бути не лише корисною для розробників, а й для самих AI агентів, надаючи їм жвавість та передбачуваність у взаємодії з кінцевими точками.