Ga naar de hoofdinhoud

Brixxs kennisbank

HubSpot API-koppeling: van gewonnen deal naar administratie

Een HubSpot API-koppeling verbindt CRM-gegevens met je website, Exact Online, AFAS of andere bedrijfssoftware. Een bruikbaar begin is één proces: een gewonnen deal gecontroleerd overdragen naar de administratie. Daarvoor zijn de relaties tussen deal, bedrijf en contactpersoon minstens zo belangrijk als de losse velden.

Maak van de gewonnen deal een complete overdracht

Leg vast wat er klaar moet zijn voordat een deal wordt doorgezet: de juiste klant, factuurgegevens, orderregels en een verantwoordelijke medewerker. Een commerciële fasewijziging is niet automatisch bewijs dat alle administratieve gegevens compleet zijn. Laat een ontbrekend gegeven eerst beoordelen.

HubSpot beschrijft records als objecten met properties en associations. Een deal kan aan een bedrijf en meerdere contacten gekoppeld zijn. Bepaal welke relatie jouw administratie nodig heeft, bijvoorbeeld de factuurklant en het contact voor opvolging. Lees de CRM API-documentatie.

Infographic en PDF

De belangrijkste aandachtspunten

  • Verbind deal, bedrijf en contactpersoon bewust
  • Bewaar de bron-ID’s bij iedere overdracht
  • Kies toegang passend bij REST of webhooks
  • Test een gewijzigde deal na de eerste overdracht

4 pagina's · 294 KB. Om terug te lezen of met een collega te bespreken.

Video: HubSpot koppelen: een gewonnen deal is pas het begin

33 seconden · Nederlands gesproken, met tekst in beeld. Video openen

HubSpot verbinden met Exact Online, AFAS of je website? Kies de juiste toegang en leg vast hoe deal, bedrijf, contact en factuurstatus samenhangen.

Lees de gesproken tekst van de short

Een gewonnen HubSpot-deal automatisch doorzetten naar je administratie? Controleer eerst het bedrijf, de contactpersoon en de orderregels. In HubSpot zijn dit afzonderlijke records met relaties. Bewaar hun referenties, zodat een tweede melding geen tweede klant of opdracht maakt. Kies daarna toegang die past: een service key voor eenvoudige REST-aanvragen of een app voor functies zoals webhooks. Test ook een gewijzigde deal na overdracht. De aanpak en checklist staan bij dit artikel van Brixxs. Neem contact op voor advies over een passende aanpak.

Service key, static token of OAuth?

  • Eenvoudige REST-overdracht binnen je account: een service key kan de benodigde objectrechten begrenzen. Service keys kunnen niet worden gebruikt voor webhookauthenticatie of UI-extensies; zie de officiële uitleg.
  • App voor één account: beoordeel of een app met static token past bij de benodigde functies.
  • App voor meerdere HubSpot-accounts: gebruik de ondersteunde OAuth-route, met toegang en tokens per account.

De authenticatiedocumentatie helpt die keuze te toetsen. Een bestaande private app hoeft niet blind vervangen te worden: inventariseer eerst welke acties en gebeurtenissen de koppeling gebruikt.

Houd updates gekoppeld aan de bestaande records

Bewaar HubSpot-record-ID’s en de verwijzingen naar het doelsysteem. Gebruik een bedrijfsnaam niet als enige sleutel; verschillende klanten kunnen dezelfde naam hebben. Leg ook de richting per veld vast. Een wijziging van een marketingcontact mag niet ongemerkt het gecontroleerde factuuradres vervangen.

Voor actuele wijzigingen kun je periodiek ophalen of, wanneer app en object dit ondersteunen, webhooks configureren. Verifieer de herkomst en verwerk een opnieuw ontvangen gebeurtenis zonder dubbele klant of opdracht.

Test de uitzondering die sales morgen tegenkomt

Test een nieuwe deal, een ontbrekend factuurveld, twee gekoppelde contacten en een wijziging nadat de deal al is overgedragen. Controleer ook een tijdelijke storing. Maak zichtbaar welke overdracht is gelukt, wat is tegengehouden en wie een correctie mag vrijgeven.

Voor de andere kant van de koppeling lees je over de AFAS API en onze Exact Online specialist. Voor bredere inrichting is er de HubSpot specialist. Bespreek je gewenste overdracht met Brixxs met een geanonimiseerde deal als voorbeeld.