HubSpot koppelen aan APIcenter

Om HubSpot te koppelen, geef je APIcenter toegang tot je HubSpot-account. Neem de tijd voor de voorbereiding: om een app in HubSpot te verbinden, heb je de juiste rechten nodig.

Voordat je begint

• Je hebt een HubSpot-account en je kunt inloggen met een gebruiker die apps mag verbinden. Volgens HubSpot is dat een Super Admin, of een gebruiker met toegang tot de App Marketplace.
• Mag jouw gebruiker dat niet, dan heeft een Super Admin in HubSpot de toegang nodig om de app goed te keuren. Vraag dat vooraf.
• Weet welke pipelines en lifecycle stages je wilt gebruiken. Je vult ze later in de instellingen van de flows in.

Stap 1: Start de koppeling in APIcenter

1. Ga in APIcenter naar Applicaties en kies HubSpot onder Nieuwe applicatie koppelen. Je kunt dit ook doen in stap 2 van de wizard, Verbind je apps.
2. Vul een Weergavenaam in: een naam die je zelf kiest. Handig als je meerdere HubSpot-accounts koppelt.
3. Vul de velden in die APIcenter toont. Stuurt APIcenter je door naar HubSpot, kies dan het HubSpot-account waaraan je APIcenter wilt koppelen en keur de toegang goed die gevraagd wordt. Daarna keer je terug naar APIcenter.
4. Klik op Testverbinding. APIcenter slaat de gegevens op en test de verbinding. Toont APIcenter in plaats daarvan een knop Autoriseren, klik dan daarop en rond de autorisatie af.

Welke rechten er nodig zijn

APIcenter leest en schrijft in HubSpot onder meer contacten, bedrijven, deals, producten en orderregels (line items), en de eigenschappen en pipelines daarvan. Staan er rechten niet aan, dan werkt de verbinding wel, maar mislukt een flow bij het lezen of schrijven van dat onderdeel. Volgens HubSpot ontbreekt bij een foutmelding over integratierechten vaak het recht om eigenschapsinstellingen te bewerken (Edit property settings). Dat recht heb je nodig als APIcenter eigenschappen mag aanmaken, bijvoorbeeld met de instelling Create missing properties in the target system.

Veelvoorkomende problemen

• Je kunt de app niet verbinden of goedkeuren. Controleer of je gebruiker Super Admin is of toegang heeft tot de App Marketplace. Laat anders een Super Admin de toegang goedkeuren.
• Een flow meldt dat een pipeline of fase niet is gevonden. Controleer de naam of het ID in de instellingen van de flow. Hoofdletters maken niet uit, maar de naam moet precies kloppen met HubSpot. Staat een fase in meer dan één pipeline en laat je de pipeline leeg, dan stopt de flow met een foutmelding. Vul dan ook de pipeline in.
• Een flow meldt dat een eigenschap niet bestaat, bijvoorbeeld de bedrijfseigenschap voor het e-mailadres (standaard company_email). Maak de eigenschap aan in HubSpot, of zet Create missing properties in the target system aan als APIcenter hem zelf mag aanmaken.
• Een klant of deal die je net hebt aangemaakt, wordt niet gevonden. Volgens HubSpot kan het even duren voordat nieuwe records in zoekresultaten verschijnen. APIcenter zoekt in HubSpot om te controleren of iets al bestaat.
• HubSpot meldt te veel verzoeken. HubSpot beperkt zoekverzoeken tot 5 per seconde per account. Verlaag dan het aantal records per run met Amount to process of verleng het interval tussen runs.

Volgende stappen

Maak een integratie met HubSpot en controleer de instellingen. Voor orders heb je een pipeline en een dealfase nodig waarin APIcenter de deals aanmaakt. Zie Verkooporders naar HubSpot sturen en HubSpot verbindings- en integratie-instellingen.

Meer informatie van HubSpot

• Authenticatie bij de HubSpot API
• Toegang tot apps beheren
• Apps installeren vanuit de HubSpot Marketplace
• Foutmelding over integratierechten oplossen