Integracja · RP-INT-01

Clay + HubSpot: wzbogacanie danych i synchronizacja z CRM

Integracja nie oznacza, że Clay i HubSpot bez kontroli nadpisują dane między sobą. HubSpot pozostaje głównym źródłem danych, Clay pobiera wskazane rekordy, wzbogaca je i zapisuje z powrotem tylko te informacje, które wcześniej określisz.

Rekordy są identyfikowane po HubSpot Object ID, dzięki czemu aktualizujesz właściwe kontakty, firmy i transakcje bez tworzenia duplikatów.

Na tej stronie pokazujemy, jakie obiekty możesz synchronizować, jak działa mapowanie pól i OAuth, jak zabezpieczyć dane przed nadpisaniem oraz jakie są ograniczenia integracji Clay z HubSpot.

Synchronizacja działa według harmonogramu, nie w czasie rzeczywistym. Zadania w HubSpot wymagają osobnej konfiguracji.

Clay
HubSpot
n8n
Python
Jak płyną dane: odczyt → wzbogacenie → kontrolowany zapis
Klucz: Object ID
1 · Odczyt
HubSpot jest źródłem prawdy — kontakt, firma, deal, obiekt własny
Pobranie z listy lub filtru · Object ID zostaje przy rekordzie
2 · Wzbogacenie
Tabela Clay: waterfall enrichment, research Claygent, ICP scoring
Zatrzymuje się na pierwszej dobrej odpowiedzi
3 · Kontrola
Przed zapisem sprawdzamy, czy dane powinny zostać zaktualizowane.
Czy pole jest puste? Czy Clay może je zmienić? Czy wynik spełnia wymagany próg pewności?
4 · Zapis do HubSpot
Clay zapisuje wybrane dane z powrotem do właściwego rekordu na podstawie Object ID.
Możesz również zachować powiązania między kontaktami, firmami i transakcjami.
Konflikt: wygrywa HubSpot, chyba że pole jest przypisane do Clay
Częstotliwość: domyślnie co 24 godziny
Zanim wdrożysz

Ograniczenia integracji
Clay + HubSpot

01 · Częstotliwość

To nie jest synchronizacja w czasie rzeczywistym

Clay pobiera dane z HubSpot według harmonogramu. Domyślnie odbywa się to co 24 godziny, ale harmonogram możesz zmienić w ustawieniach źródła, a import uruchomić ręcznie w dowolnym momencie.

Natywna integracja z HubSpot jest dostępna od planu Clay Pro. Jeśli proces ma reagować natychmiast, potrzebujesz webhooków i dodatkowej automatyzacji.

02 · Obiekty

Zadania nie są wbudowanym obiektem

Natywna integracja Clay pozwala pobierać, tworzyć i aktualizować rekordy oraz ich powiązania. Obsługuje też wyszukiwanie właścicieli rekordów i sprawdzanie, czy kontakt jest zapisany do sekwencji.

Zadań nie ma na tej liście. Można je tworzyć przez API HubSpot, ale wymaga to osobnej konfiguracji.

03 · Konflikty

Clay nie wie automatycznie, które dane są lepsze

Przed zapisem do HubSpot trzeba ustalić, kiedy Clay może zmienić dane. Możesz np. aktualizować tylko puste pola, wymagać określonego poziomu pewności albo ustalić priorytet źródeł. Dzięki temu enrichment nie nadpisze poprawnych danych w CRM.

Clay sam rekomenduje stosowanie takich warunków przy aktualizacji rekordów.

04 · Limity

Limity API HubSpot

HubSpot publikuje swoje limity. Aplikacja połączona przez OAuth może wysłać 100 zapytań na 10 sekund. Limit dzienny zależy od pakietu: od 250 000 na Free i Starter do 1 000 000 na Enterprise.

Osobno działa CRM Search API, ograniczone do 4 zapytań na sekundę. Przy większych bazach to zwykle ono jest wąskim gardłem, nie limit dzienny.

Obsługiwane obiekty HubSpot

Jakie dane możesz synchronizować między Clay a HubSpot?

Natywna integracja Clay z HubSpot pozwala pobierać i aktualizować najważniejsze rekordy CRM: kontakty, firmy, transakcje i obiekty niestandardowe. Bardziej zaawansowane działania, takie jak tworzenie zadań, można obsłużyć osobno przez API HubSpot.

Obiekt
Odczyt
Zapis
Klucz dopasowania / uwagi
Kontakt
Tak, natywnie
Tak, natywnie
Object ID · zapasowo adres e-mail
Firma
Tak, natywnie
Tak, natywnie
Object ID · zapasowo domena
Deal
Tak, natywnie
Tak, natywnie
Object ID · powiązania wskazane wprost
Obiekt własny
Tak, natywnie
Tak, natywnie
Schemat musi już istnieć w portalu · obiekty niestandardowe wymagają HubSpot Enterprise
Zadanie
Przez API HubSpot
Nieobsługiwane w natywnej integracji Clay–HubSpot
Tabela RP-INT-01/T1 · zweryfikowana względem publicznej dokumentacji Clay i HubSpot, 27 sierpnia 2026 · Rev A
Konfiguracja

Jak połączyć Clay z HubSpot krok po kroku

Clay łączy się z HubSpot przez OAuth. Przy konfiguracji możesz ograniczyć dostęp tylko do danych i działań, których naprawdę potrzebujesz. Jeśli Clay ma jedynie pobierać dane, nie musisz dawać mu uprawnień do ich edycji.

S-01

Połącz konto przez OAuth

W Clay dodaj nowe połączenie z HubSpot i zaloguj się na konto, które ma dostęp do potrzebnych danych. Clay pokaże, które uprawnienia są wymagane, a które możesz włączyć lub wyłączyć.

S-02

Wybierz potrzebne uprawnienia

Nadaj Clay tylko taki dostęp, jakiego wymaga dany proces. Możesz np. pozwolić na odczyt kontaktów, ale wyłączyć ich edycję. Jeśli później potrzebujesz dodatkowych uprawnień, możesz zmienić je przez ponowne połączenie konta.

S-03

Wybierz dane do importu

Wybierz typ rekordów, które chcesz pobierać z HubSpot. Możesz zaimportować wszystkie rekordy albo ograniczyć import do konkretnej listy.

S-04

Ustal, które pola Clay może aktualizować

Określ, które dane Clay tylko odczytuje, a które może zapisywać z powrotem do CRM. Do aktualizacji rekordu Clay wykorzystuje jego HubSpot Object ID, dlatego warto zachować tę wartość w tabeli.

S-05

Przetestuj integrację na małej próbce

Zanim uruchomisz synchronizację dla całej bazy, sprawdź ją na kilkudziesięciu rekordach. Zweryfikuj, które pola zostały zmienione i czy dane trafiają do właściwych rekordów.

Zestawienie uprawnień · RP-INT-01/S1
crm.objects.contacts.read
Wymagane
crm.objects.contacts.write
Wymagane
crm.objects.companies.*
Jeśli używane
crm.objects.deals.*
Jeśli używane
crm.schemas.custom.read
Obiekt własny
crm.objects.owners.read
Routing leadów

Nazwy uprawnień są zgodne z konwencją publicznego API HubSpot i warto potwierdzić je w ustawieniach aplikacji w twoim portalu w momencie łączenia. Zweryfikowane 27 sierpnia 2026.

Mapowanie pól

Jak uniknąć duplikatów przy synchronizacji Clay z HubSpot

Najbezpieczniej aktualizować istniejące rekordy po HubSpot Object ID, zamiast próbować dopasowywać je po nazwie firmy czy adresie e-mail. Trzeba też ustalić, które pola Clay może aktualizować i kiedy powinien pozostawić obecną wartość bez zmian.

M-01 · DOPASOWANIE REKORDÓW

Używaj HubSpot Object ID

Przechowuj Object ID rekordu HubSpot w tabeli Clay i wykorzystuj je przy zapisie danych z powrotem do CRM. Dzięki temu Clay aktualizuje właściwy rekord zamiast tworzyć kolejny.

M-02 · NADPISYWANIE DANYCH

Nie nadpisuj danych pustą wartością

Jeśli enrichment nie zwróci wyniku, Clay nie powinien usuwać istniejącej wartości w HubSpot. Przy każdym mapowanym polu ustaw warunek, który pomija puste wyniki.

M-03 · MAPOWANIE PÓL

Ustal, które pola może aktualizować Clay

Nie każde pole powinno być edytowane przez automatyzację. Określ, które dane uzupełnia Clay, które pozostają tylko do odczytu, a które powinny być zmieniane wyłącznie przez handlowca lub inny proces.

Kolumna w Clay
Właściwość w HubSpot
Kto aktualizuje
Reguła zapisu
hs_object_id
hs_object_id
HubSpot
Tylko odczyt
employee_count
numberofemployees
Clay
Pomiń, jeśli puste
icp_fit_score
rp_icp_score
Clay
Nadpisz
score_inputs_json
rp_score_inputs
Clay
Nadpisz
lifecyclestage
lifecyclestage
Proces
Nigdy z Clay
hubspot_owner_id
hubspot_owner_id
Routing leadów
Tylko automatyzacja
Zestawienie RP-INT-01/T2 · mapowanie poglądowe, zastępowane audytem właściwości w twoim portalu · Rev A
Zastosowania

4 sposoby, jak wykorzystać integrację Clay z HubSpot

Clay może wzbogacać dane, oceniać leady i wykrywać sygnały, a HubSpot przechowuje wynik i uruchamia dalsze działania. Poniżej cztery procesy, które najczęściej warto automatyzować.

U-01 · WZBOGACANIE DANYCH

Automatycznie uzupełniaj brakujące dane w HubSpot

Clay może uzupełniać rekordy firm o liczbę pracowników, branżę, używane technologie i inne dane potrzebne zespołowi sprzedaży. Do HubSpot zapisujesz tylko te informacje, które spełniają ustalone warunki.

Wyzwalacz: widok z harmonogramu · Zapis: pomiń, jeśli puste
U-02 · LEAD SCORING

Oceniaj i priorytetyzuj nowe leady

Nowy lead może zostać automatycznie wzbogacony i oceniony na podstawie dopasowania do ICP, wielkości firmy, branży i wybranych sygnałów. Wynik wraca do HubSpot, dzięki czemu handlowiec od razu widzi, który lead warto obsłużyć jako pierwszy.

Wyzwalacz: formularz wysyła webhook · Zapis: nadpisanie
U-03 · ROUTING LEADÓW

Automatycznie przypisuj leady do właściwego handlowca

Clay uzupełnia dane potrzebne do routingu, np. kraj, segment czy wielkość firmy. Na ich podstawie HubSpot lub dodatkowa automatyzacja może przypisać lead do odpowiedniej osoby lub zespołu.

Wyzwalacz: zmiana właściwości · Zapis: przez automatyzację
U-04 ·ZADANIA W HUBSPOT

Twórz zadania na podstawie sygnałów z Clay

Jeśli Clay wykryje ważny sygnał, np. zmianę pracy, wzrost zatrudnienia albo pojawienie się nowej technologii, możesz automatycznie utworzyć zadanie dla handlowca w HubSpot. Ten proces wymaga dodatkowej konfiguracji przez API lub warstwę automatyzacji.

Poza natywną integracją · wymaga API HubSpot
Webhooki i zaawansowana automatyzacja

Clay + HubSpot: synchronizacja cykliczna czy webhooki?

Synchronizacja cykliczna sprawdza się, gdy dane mogą odświeżać się co kilka godzin. Jeśli proces ma reagować od razu na formularz, zmianę danych lub nowy sygnał, potrzebna jest automatyzacja oparta na zdarzeniach.

A · SYNCHRONIZACJA CYKLICZNA

Synchronizacja według harmonogramu

01
HubSpot udostępnia wybrane rekordy
02
Clay pobiera je i uzupełnia dane
03
Wyniki są zapisywane z powrotem do właściwych rekordów
Nakład na uruchomienie
Niski
Opóźnienie
Godziny
Ponowne próby
Niedostępne

Najlepiej sprawdza się przy regularnym wzbogacaniu bazy, aktualizacji scoringu i porządkowaniu danych.

B · Webhook sterowany zdarzeniami

Reakcja na zmiany w czasie rzeczywistym

01
Zdarzenie w HubSpot: wysłanie formularza lub zmiana właściwości
02
Webhook uruchamia automatyzację
03
Automatyzacja wysyła rekord do Clay
04
Wynik wraca do HubSpot i uruchamia kolejne działanie
Nakład na uruchomienie
Wdrożenie
Opóźnienie
Sekundy
Ponowne próby
Jawne + kolejka błędów

Najlepiej sprawdza się przy routingu leadów, natychmiastowym wzbogacaniu danych, reakcji na sygnały i automatycznym tworzeniu zadań.

Który wariant wybrać

Pierwszy wariant wykorzystuje standardową synchronizację Clay. Drugi wymaga dodatkowej automatyzacji, na przykład w n8n lub Make, ale pozwala reagować na zdarzenia w kilka sekund.

Limity, uprawnienia i plany

Limity integracji Clay z HubSpot

Integracja ma kilka ograniczeń, które warto znać przed wdrożeniem. Część zależy od planu Clay lub HubSpot, a część od sposobu, w jaki zbudujesz synchronizację.

Ograniczenie
Wartość
Skąd to wiemy
Częstotliwość synchronizacji, domyślna
Co 24 godziny
Dokumentacja Clay
Czy harmonogram da się zmienić
Tak — w ustawieniach źródła. Import można też uruchomić ręcznie
Dokumentacja Clay
Limit subskrypcji webhooków
1 000 subskrypcji na aplikację
Dokumentacja HubSpot
Limity API HubSpot
100 zapytań / 10 s dla OAuth · dziennie od 250 000 (Free, Starter) do 1 000 000 (Enterprise) · CRM Search 4 zapytania / s
Dokumentacja HubSpot
Rozstrzyganie konfliktów
Clay nie rozstrzyga konfliktów sam. Decydują reguły, które ustawisz przy mapowaniu pól
Nasza rekomendacja
Cennik
Nie podajemy go tutaj. Cenniki Clay i HubSpot się zmieniają i zależą od włączonych opcji, więc wyceniamy przy audycie, na podstawie twojego rzeczywistego wolumenu.
Wyceniamy przy audycie
Zestawienie RP-INT-01/T3 · na podstawie publicznej dokumentacji Clay i HubSpot, stan na 27 sierpnia 2026 · Rev A
Uprawnienia

Integracja dziedziczy uprawnienia HubSpot po użytkowniku, który ją autoryzował. Jeśli ten użytkownik może zmieniać kwoty na dealach, integracja też może — i właśnie dlatego warto założyć osobne konto techniczne z ograniczoną rolą.

Bezpieczeństwo i ochrona danych

Obaj dostawcy publikują atestacje SOC 2 Type 2 i oferują umowę powierzenia danych obejmującą przetwarzanie w Unii Europejskiej. Przed podpisaniem sprawdź aktualny zakres na ich własnych stronach poświęconych bezpieczeństwu — nie powtarzamy szczegółów certyfikacji, które mogą stracić ważność.

FAQ

Integracja Clay z HubSpot — najczęściej zadawane pytania

Czy Clay integruje się z HubSpot?

Tak, natywnie, przez OAuth. Importujesz rekordy z HubSpot do tabeli w Clay, uzupełniasz je i zapisujesz wyniki z powrotem do tych samych rekordów.

Czy integracja działa w obie strony?

Czyta i zapisuje, więc tak — ale nie jest lustrem. Dane wychodzą z HubSpot według harmonogramu i wracają na warunkach, które sam ustalasz. Nie ma tu ciągłej dwustronnej replikacji i nie warto projektować tak, jakby była.

Które obiekty HubSpot obsługuje Clay?

Kontakty, firmy i deale, a także obiekty własne, których schemat już istnieje w twoim portalu. Zobacz tabelę powyżej.

Czy Clay obsługuje własne obiekty HubSpot?

Tak, w odczycie i zapisie, o ile obiekt i jego właściwości są już zdefiniowane w HubSpot. Clay nie utworzy schematu za Ciebie. Same obiekty niestandardowe wymagają HubSpot Enterprise.

Czy Clay obsługuje zadania w HubSpot?

Nie w natywnej integracji. Zadania tworzy się przez API HubSpot, więc potrzebujesz dodatkowej automatyzacji. To jedna z rzeczy, które najczęściej dobudowujemy przy tej integracji.

Jak uniknąć duplikatów przy aktualizacji HubSpot z Clay?

Dopasowuj po HubSpot Object ID, a nie po adresie e-mail czy nazwie firmy, i ustaw zapis jako aktualizuj, jeśli znaleziono, utwórz, jeśli nie. Zachowaj kolumnę z identyfikatorem w tabeli i nie pozwól, by nadpisało ją uzupełnianie danych.

Czy Clay może nadpisać istniejące wartości w HubSpot?

Tak, może. Dlatego przy każdym mapowanym polu włącz pomijanie pustych wartości i z góry ustal, które pola Clay w ogóle może zmieniać. Clay nie rozstrzygnie tego za Ciebie.

Jak często Clay synchronizuje się z HubSpot?

Domyślnie co 24 godziny. Harmonogram możesz zmienić w ustawieniach źródła, a import uruchomić ręcznie w dowolnym momencie. Natywna integracja z HubSpot jest dostępna od planu Clay Pro.

Czy Clay może reagować na zmiany w HubSpot w czasie rzeczywistym?

Nie przez samą synchronizację. Żeby reagować w kilka sekund, potrzebujesz warstwy pośredniej: webhook z HubSpot uruchamia automatyzację, ta odpytuje Clay o jeden rekord, a wynik wraca do HubSpot. To wariant B opisany wyżej.

Jakie są limity API między Clay a HubSpot?

Clay nie publikuje limitów dla samej integracji. W praktyce obowiązują limity API HubSpot: 100 zapytań na 10 sekund dla aplikacji OAuth i limit dzienny zależny od pakietu. Osobno liczy się CRM Search API, ograniczone do 4 zapytań na sekundę.

Następny krok

Połącz Clay z HubSpot na swoich danych

W ciągu dwóch tygodni przygotujemy mapę pól, zasady synchronizacji i pierwszą działającą tabelę w Clay. Ustalimy, które dane Clay może aktualizować, jak uniknąć duplikatów i czy potrzebujesz dodatkowej automatyzacji.

Rezultaty audytu · RP-INT-01
Kto aktualizuje które pole
D-01
Specyfikacja mapowania · Object ID
D-02
Decyzja o częstotliwości synchronizacji
D-03
Zakres dodatkowej automatyzacji · zadania
D-04