Parametry techniczne HubSpot API
4 sposobów automatyzacji z HubSpot API
Poniżej znajdziesz konkretne zastosowania HubSpot API w projektach automatyzacji procesów B2B — z opisem logiki, endpointów i realnej oszczędności czasu.
Automatyczne tworzenie deala po wypełnieniu formularza
Formularz na stronie (HubSpot Forms lub zewnętrzny) wysyła dane przez API. Automatyzacja sprawdza, czy kontakt istnieje w CRM (GET /crm/v3/contacts/search), jeśli nie — tworzy go (POST /crm/v3/contacts). Następnie tworzy deal (POST /crm/v3/deals) powiązany z kontaktem i przypisuje właściciela na podstawie reguł (branża, region).
POST /crm/v3/contactsPOST /crm/v3/dealsGET /crm/v3/contacts/searchKwalifikacja leadów przez AI po uzupełnieniu danych
Trigger: właściwość kontaktu zmieniona (np. "Company Size" uzupełniona). Webhook wysyła dane do automatyzacji. Make pobiera pełny profil kontaktu z HubSpot API i wysyła do Claude API z promptem kwalifikacji. AI ocenia lead — Make aktualizuje właściwości w HubSpot (PATCH /crm/v3/contacts/{id}) i przenosi deal na odpowiedni etap.
GET /crm/v3/contacts/{id}PATCH /crm/v3/contacts/{id}PATCH /crm/v3/deals/{id}Synchronizacja HubSpot z systemem fakturowania
Po zamknięciu deala (stage = "closedwon") webhook triggeruje Make. Make pobiera dane deala, tworzy fakturę w Fakturowni/Lexoffice i aktualizuje deal w HubSpot — dodaje ID faktury i link PDF jako właściwości customowe. Zapis do HubSpot przez PATCH /crm/v3/deals/{id}.
GET /crm/v3/deals/{id}PATCH /crm/v3/deals/{id}GET /crm/v3/ownersRaportowanie pipeline i prognoza sprzedaży
Codziennie skrypt pobiera wszystkie deale z aktywnych pipeline'ów (GET /crm/v3/deals z filter na pipeline i stage), agreguje wartości według etapu i właściciela, eksportuje do Google Sheets lub BigQuery. Zarząd widzi prognozę sprzedaży zaktualizowaną o 8:00 rano bez ręcznych raportów.
POST /crm/v3/deals/searchGET /crm/v3/pipelines/dealsKluczowe endpointy HubSpot API
Poniżej lista endpointów najczęściej używanych w automatyzacjach. Każdy endpoint jest częścią standardowego REST API i obsługuje autentykację przez OAuth 2.0 lub Private App Token.
/crm/v3/contacts/search
Wyszukaj kontakt po e-mail, nazwie, właściwości
/crm/v3/contacts
Utwórz nowy kontakt
/crm/v3/contacts/{id}
Zaktualizuj właściwości kontaktu
/crm/v3/deals
Utwórz deal w pipeline
/crm/v3/deals/search
Wyszukaj deale z filtrami
/crm/v3/deals/{id}
Przenieś deal na etap, aktualizuj właściwości
/marketing/v3/emails/send
Wyślij transakcyjny e-mail marketingowy
Zanim wdrożysz integrację produkcyjnie, przetestuj endpointy w środowisku sandbox (jeśli dostępne) lub na dedykowanym koncie testowym. Dla HubSpot API dokumentację techniczną znajdziesz na https://developers.hubspot.com/docs/api/overview.
Przykładowy przepływ: Przepływ: Formularz → HubSpot Contact + Deal → Kwalifikacja AI → Slack
- Lead wypełnia formularz na stronie (HubSpot Forms embed)
- HubSpot tworzy kontakt i zdarzenie form_submission
- Webhook (HubSpot → Make): zdarzenie form_submission z ID kontaktu
- Make pobiera pełny profil: GET /crm/v3/contacts/{id}?properties=company,jobtitle,country,hs_analytics_source
- Make wysyła dane do Claude API — AI ocenia potencjał leadu (1–10)
- Score ≥ 7: Make tworzy deal (POST /crm/v3/deals) i przypisuje do etapu "Kwalifikowany"
- Make wysyła alert na Slack z podsumowaniem AI i linkiem do kontaktu w HubSpot
- Score < 7: Make dodaje kontakt do sekwencji nurturowej
Jak JustAutomate wdraża integracje HubSpot
W projektach JustAutomate integracja HubSpot API to jeden z najczęstszych elementów automatyzacji. Nasz proces zaczyna się od audytu API — sprawdzamy dostępne endpointy, rate limity, stabilność tokenów i formatów danych po stronie klienta.
W większości przypadków używamy Make lub n8n jako middleware — narzędzia, które łączą HubSpot z innymi systemami bez pisania kodu. Dla złożonych przypadków (własna logika transformacji danych, integracja z legacy systemem, niestandardowe formaty) piszemy skrypty Node.js lub Python z pełną obsługą błędów i logowaniem.
Każda integracja, którą budujemy, ma monitoring — wiemy natychmiast, gdy API zwróci błąd 5xx lub przekroczymy rate limit. Klient nie dowiaduje się o awarii z opóźnieniem — system jest samo-naprawiający i alertuje nas zanim wpłynie to na procesy.
Jeśli chcesz zintegrować HubSpot ze swoimi systemami, możemy omówić zakres i ROI w 30-minutowej rozmowie. Pierwsza konsultacja jest bezpłatna.
FAQ — najczęstsze pytania o HubSpot API
Jaki token wybrać do HubSpot API — OAuth czy Private App?
Dla automatyzacji wewnętrznych (n8n, Make, własne skrypty) używaj Private App Token — prostszy w konfiguracji, nie wygasa co godzinę. OAuth 2.0 stosuj gdy budujesz aplikację dla zewnętrznych użytkowników lub marketplace HubSpot.
Jak HubSpot API obsługuje właściwości customowe (custom properties)?
Właściwości customowe tworzysz raz w panelu HubSpot (CRM → Właściwości) lub przez API (POST /crm/v3/properties/contacts). Następnie używasz ich nazwy wewnętrznej (np. "custom_invoice_id") w GET/PATCH tak samo jak standardowych właściwości.
Ile requestów API mogę wysłać na minutę?
HubSpot stosuje rate limiting: 100–150 req/10 sekund dla Private Apps (w zależności od planu). Dla operacji masowych używaj Batch API — np. POST /crm/v3/contacts/batch/update — który przetwarza do 100 rekordów w jednym żądaniu.
Jak skonfigurować webhook w HubSpot?
Webhooki konfiguruje się w Apps → Webhooks w panelu dewelopera. Wybierasz typ zdarzenia (contact.creation, deal.propertyChange itp.), podajesz URL i sekret do weryfikacji podpisu. HubSpot wysyła POST z tablicą zdarzeń w JSON.
Potrzebujesz integracji HubSpot
w swoich procesach?
Budujemy integracje HubSpot API z CRM, ERP, fakturowaniem i narzędziami AI. Bezpłatna konsultacja — 30 minut, konkretny plan z ROI.