HubSpot API koppelen aan je website.

HubSpot is een CRM met marketing, sales en service eromheen. Contacten, bedrijven, deals, e-mail, formulieren en rapportage zitten in hetzelfde systeem, en dat is precies de reden dat bedrijven het kiezen: één plek waar de klantrelatie staat.

Voor een website is het de plek waar een lead terechtkomt. De vraag is alleen hoe hij daar komt, en dat is waar de meeste sites een keuze maken die hun later opbreekt. Werk je al in Salesforce, dan is een koppeling met Salesforce de route, met dezelfde aanpak voor bron en campagne.

HubSpot heeft een REST API met een datum als versie in het adres, dus een aanroep zegt zelf welke versie hij bedoelt en verandert niet onder je handen.

Aanmelden ging jarenlang met een private app, die HubSpot nu een legacy private app noemt: je maakt hem aan in je eigen portal, geeft hem precies de rechten die de koppeling gebruikt, en krijgt een toegangstoken. Voor nieuwe koppelingen wijst HubSpot naar service keys, die je in je account aanmaakt onder Settings, Integrations, Service Keys. De oude API-sleutel wordt niet meer ondersteund.

Wij zetten dat token op de server, nooit in de pagina. Het formulier op je site stuurt naar je eigen server, en die praat met HubSpot. Zo blijft de sleutel uit de browser en kun je onderweg nog dingen toevoegen, zoals de pagina waar het formulier stond.

Heen gaat wat een bezoeker invult, aangevuld met de pagina en de utm-waarden. In HubSpot wordt dat een contact.

Voor dat wegschrijven zijn er twee routes. De formulier-API neemt een inzending aan op een formulier dat in HubSpot bestaat, met de velden, de toestemming voor e-mail en een context met de pagina en de trackingcookie van HubSpot. Die route vraagt geen token, en ook die aanroep laten wij via de server lopen. De CRM API schrijft rechtstreeks naar contacten, bedrijven en deals. De eerste houdt de formulierrapportage in HubSpot heel, de tweede geeft meer vrijheid.

Terug komen wijzigingen in het CRM via webhooks. Bij een gewoon contactformulier is dat meestal niet nodig.

Plant een bezoeker een afspraak, dan kan die via Calendly koppelen met bron en campagne bij het contact in HubSpot komen. Gebruik je Leadinfo om bezoekende bedrijven te herkennen, dan kun je Leadinfo koppelen aan HubSpot, zodat die bedrijven direct bij de juiste eigenaar staan.

Een ingesloten HubSpot-formulier is de snelste route en meestal de verkeerde. Het komt met eigen opmaak die je maar half kunt bijsturen, het laadt scripts van buiten, en het valt op een telefoon net anders dan de rest van je pagina.

Belangrijker: het is niet van jou. Je kunt er geen eigen stappen in zetten, geen eigen validatie, geen eigen bedankpagina met een meetbare conversie.

Ons formulier staat in je eigen ontwerp en stuurt vanaf de server door naar HubSpot. Wat je wint is de opmaak, de snelheid en de meting. Wat je verliest is niets: het contact komt er precies zo in te staan.

Werk je met Pipedrive in plaats van HubSpot, dan speelt dezelfde afweging tussen het formulier van de leverancier en je eigen formulier. Die staat uitgewerkt bij het Pipedrive-formulier op je website.

Dit is waar de koppeling meer doet dan gegevens doorgeven. Bij een inzending sturen wij mee op welke pagina het formulier stond en met welke campagnewaarden iemand binnenkwam. Met bedrijfsgegevens uit de KVK API komt het bedrijf meteen compleet in HubSpot.

Daarmee zie je in HubSpot niet alleen dat er een lead is, maar ook waar hij vandaan komt: welke advertentie, welke zoekterm, welke pagina. Dat is de koppeling tussen je advertentiebudget en je omzet, en zonder deze stap blijft dat giswerk.

Wij zetten die velden bij het inrichten vast, zodat ze in elk rapport terugkomen in plaats van in een vrij tekstveld te verdwijnen. Dat deel van het werk valt bij ons onder data en tracking.

1. Toegang. Iemand met beheerrechten in je HubSpot-portal maakt de app aan waar de koppeling op draait. In bestaande accounts is dat vaak een legacy private app, onder Development en dan Legacy apps. Volgens HubSpot kun je die in accounts van vóór 28 september 2026 tot 26 oktober 2026 nog nieuw aanmaken, in nieuwere accounts al niet meer. Voor iets nieuws is een service key de route.
2. Rechten. Je vinkt alleen de scopes aan die de koppeling gebruikt, bijvoorbeeld het lezen en schrijven van contacten.
3. Testen. HubSpot biedt developer testaccounts: gratis, met negentig dagen toegang tot veel Enterprise-functies. Met Enterprise kan het ook in een sandbox.
4. Livegang. Het token gaat als omgevingsvariabele op de server, het formulier gaat live, en we controleren met een paar inzendingen of velden en bron goed in HubSpot staan.

Voor een private app hangt de limiet af van je abonnement. Bij Free en Starter zijn het 100 aanroepen per 10 seconden per app en 250.000 per dag voor het hele account. Bij Professional en Enterprise zijn het 190 per 10 seconden, met een hogere daglimiet. Een OAuth-app uit de marktplaats zit op 110 per 10 seconden per account.

Ga je over een limiet, dan antwoordt HubSpot met foutcode 429, en in het antwoord staat of het de limiet per 10 seconden of die per dag was. De headers X-HubSpot-RateLimit-Max en X-HubSpot-RateLimit-Remaining laten zien hoeveel ruimte er nog is. Een formulier haalt die grens zelden; een integratie die ook contacten ophaalt of bijwerkt wel.

Mist het token een scope, dan weigert HubSpot de aanroep. Wij loggen elke mislukte aanroep, zodat een inzending niet stil verdwijnt.

Op WordPress staat het formulier in je thema, en de aanroep naar HubSpot loopt via de server van je site, zodat het token uit de broncode blijft. Op een maatwerksite in Next.js ontvangt een serverroute het formulier, controleert het en stuurt het door. Moet er meer gebeuren dan een formulier, zoals een portaal naast je CRM waarin klanten hun eigen gegevens zien, dan bouwen we dat als webapplicatie.