Alles over HubSpot
HubSpot: Klanten naar HubSpot sturen
Stuur klanten uit je webshop of ERP-systeem naar HubSpot als bedrijf en contact, met de juiste pipeline en lifecycle stage.
Bijgewerkt op 9 november 2026
Deze flow stuurt klanten uit een andere applicatie, zoals een webshop of een ERP-systeem, naar HubSpot. APIcenter maakt een bedrijf en de bijbehorende contacten aan, of werkt ze bij.
Zo werkt het
- APIcenter zoekt eerst het bedrijf, in deze volgorde: op ID, op het e-mailadres van het bedrijf, op de naam en op het domein. Bestaat het bedrijf niet, dan maakt APIcenter het aan. Het e-mailadres staat in de bedrijfseigenschap die je instelt, standaard
company_email. - Een bestaand bedrijf werkt APIcenter alleen bij als Update existing companies aan staat.
- Een contact zoekt APIcenter op ID of e-mailadres. Een nieuw contact wordt aangemaakt. Een bestaand contact wordt alleen bijgewerkt als Update existing contacts aan staat. Een contact zonder e-mailadres en zonder ID slaat APIcenter over.
- Heeft de klant geen contactpersonen? Dan maakt APIcenter een contact van de gegevens van de klant zelf.
- Is een contact of bedrijf zojuist aangemaakt, dan koppelt APIcenter ze aan elkaar. Bestaan allebei al, dan blijft de bestaande koppeling zoals ze is.
- Wil je alleen contacten, geen bedrijven? Zet dan Only process contact information aan.
- Nieuwe bedrijven en contacten krijgen de pipeline en lifecycle stage uit de instellingen: pipeline voor bedrijven, fase voor bedrijven, pipeline voor contacten en fase voor contacten. Of bestaande records ook een nieuwe pipeline en fase krijgen, bepaal je met Update pipeline & stage on existing contacts.
- Standaard stuurt APIcenter de bedrijfsnaam, het e-mailadres, het telefoonnummer, de naam en de contacten mee. Meer velden voeg je toe onder Data mapping.
Wat je eerst nodig hebt
- HubSpot is gekoppeld aan APIcenter. Zie HubSpot koppelen aan APIcenter.
- De pipelines en lifecycle stages bestaan in HubSpot. De standaardwaarden zijn
companies-lifecycle-pipeline,contacts-lifecycle-pipelineen de fasecustomer. Pas ze aan als jouw HubSpot-account andere namen of ID's heeft. - De bedrijfseigenschap voor het e-mailadres bestaat in HubSpot en de data mapping stuurt het e-mailadres van de klant ernaartoe. Standaard is dat
company_email. - De klant heeft een bedrijfsnaam. Zonder bedrijfsnaam verwerkt APIcenter alleen de contacten.
Tips
- APIcenter herkent een bedrijf ook aan de naam. Twee bedrijven met dezelfde naam worden daardoor als hetzelfde bedrijf gezien, ook als het e-mailadres verschilt.
- Volgens HubSpot kunnen de standaardtools de lifecycle stage alleen vooruit zetten. Wil je een eerdere fase zetten, dan moet de waarde eerst leeg zijn. Test dit met een voorbeeld.
- Volgens HubSpot kan het even duren voordat nieuwe records in zoekresultaten verschijnen. Stuur je dezelfde klant kort na elkaar twee keer, dan kan APIcenter het eerste record nog niet vinden.
Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.
Instellingen
De instellingen die je in het dashboard ziet, met wat elke instelling doet.
Default price list group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen prijslijstgroep mee. De waarde wordt alleen gebruikt als Enable use of a default customer price list group aan staat en je prijslijstgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
Enable use of a default customer group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen klantgroep mee. Je hebt hem alleen nodig als je klantgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Enable use of a default customer price list group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen prijslijstgroep mee. Je hebt hem alleen nodig als je prijslijstgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Field to use as company email
Customer SettingsDe naam of het label van de bedrijfseigenschap in HubSpot waarin het e-mailadres van het bedrijf staat. Standaard: company_email. APIcenter gebruikt dit e-mailadres om een bedrijf te herkennen en als herkenning van de klant in de activiteiten. Bestaat de eigenschap niet in HubSpot, dan stopt de flow met een foutmelding, tenzij Create missing properties in the target system aan staat: dan maakt APIcenter de eigenschap aan. Dit veld is verplicht. Bij het versturen moet het e-mailadres in de data mapping naar dezelfde eigenschap gaan.
Force the usage of the default customer group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen klantgroep meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je klantgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Force the usage of the default payment terms
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen betalingsvoorwaarde meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je betalingsvoorwaarde zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Force the usage of the default price list group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen prijslijstgroep meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je prijslijstgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Force the usage of the payment_method id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen betaalmethode meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je betaalmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Lifecycle stage to set for contacts
Customer SettingsDe lifecycle stage voor contacten, als naam of ID van de fase in HubSpot (hoofdletters maken niet uit). Standaard: customer. Bij Send Customer en Send Sales Order krijgen contacten die APIcenter verstuurt deze fase; dit is verplicht. Bij Get Customer en Get Sales Order werkt APIcenter de opgehaalde contacten na het ophalen bij naar deze fase; laat je het veld leeg, dan wordt er niets bijgewerkt. Volgens HubSpot kunnen de standaardtools de lifecycle stage alleen vooruit zetten; voor een eerdere fase moet de waarde eerst worden leeggemaakt. Test dit met een voorbeeld.
Make use of a default payment method id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen betaalmethode mee. Je hebt hem alleen nodig als je betaalmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Make use of a default payment terms id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen betalingsvoorwaarde mee. Je hebt hem alleen nodig als je betalingsvoorwaarde zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Only process contact information
Customer SettingsZet dit aan als je alleen contacten in HubSpot wilt aanmaken of bijwerken en geen bedrijven. APIcenter verwerkt dan geen bedrijf en koppelt het contact dus ook niet aan een bedrijf. De pipeline en fase voor bedrijven zijn dan niet nodig. Standaard staat dit uit: dan maakt APIcenter het bedrijf en de contacten aan en koppelt ze.
Pipeline to set for companies
Customer SettingsDe pipeline voor bedrijven. Vul de naam of het ID van de pipeline in HubSpot in; hoofdletters maken niet uit. Standaard: companies-lifecycle-pipeline. Bij Send Customer en Send Sales Order zet APIcenter deze pipeline en de lifecycle stage voor bedrijven op bedrijven die het verstuurt. Dit is verplicht, behalve als je alleen contacten verwerkt (Only process contact information). Bij Get Customer en Get Sales Order werkt APIcenter de opgehaalde bedrijven na het ophalen bij naar deze pipeline en fase; laat je de velden leeg, dan wordt er niets bijgewerkt. Vul pipeline en fase altijd samen in.
Pipeline to set for contacts
Customer SettingsDe pipeline voor contacten. Vul de naam of het ID van de pipeline in HubSpot in; hoofdletters maken niet uit. Standaard: contacts-lifecycle-pipeline. Bij Send Customer en Send Sales Order zet APIcenter deze pipeline en de lifecycle stage voor contacten op contacten die het verstuurt. Bij Get Customer en Get Sales Order werkt APIcenter de opgehaalde contacten na het ophalen bij naar deze pipeline en fase; laat je de velden leeg, dan wordt er niets bijgewerkt. Vul pipeline en fase altijd samen in.
Set the lifecycle stage when we create new customers
Customer SettingsDe lifecycle stage voor bedrijven, als naam of ID van de fase in HubSpot (hoofdletters maken niet uit). Standaard: customer. Bij Send Customer en Send Sales Order krijgen bedrijven die APIcenter verstuurt deze fase; dit is verplicht, behalve als je alleen contacten verwerkt. Bij Get Customer en Get Sales Order werkt APIcenter de opgehaalde bedrijven na het ophalen bij naar deze fase; laat je het veld leeg, dan wordt er niets bijgewerkt. Volgens HubSpot kunnen de standaardtools de lifecycle stage alleen vooruit zetten; voor een eerdere fase moet de waarde eerst worden leeggemaakt. Test dit met een voorbeeld.
Update pipeline & stage on existing companies
Customer SettingsBepaalt of APIcenter de pipeline en lifecycle stage ook zet op bedrijven die al in HubSpot bestaan. Staat dit aan (standaard), dan krijgen bestaande bedrijven de pipeline en fase uit de instellingen; staat het uit, dan gebeurt dat alleen bij nieuwe bedrijven. Let op: in de huidige koppeling bepaalt de instelling Update pipeline & stage on existing contacts ook of bestaande bedrijven een nieuwe pipeline en fase krijgen. Zet daarom beide instellingen hetzelfde. Een bestaand bedrijf wordt alleen bijgewerkt als Update existing companies aan staat.
Update pipeline & stage on existing contacts
Customer SettingsBepaalt of APIcenter de pipeline en lifecycle stage ook zet op contacten die al in HubSpot bestaan. Staat dit aan (standaard), dan krijgen bestaande contacten de pipeline en fase uit de instellingen; staat het uit, dan gebeurt dat alleen bij nieuwe contacten. Een bestaand contact wordt alleen bijgewerkt als Update existing contacts aan staat. Deze instelling geldt in de huidige koppeling ook voor bestaande bedrijven.
Use a mapping table to map the default payment method id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betaalmethode mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je betaalmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use customer group mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen klantgroep mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je klantgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use default payment terms id mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betalingsvoorwaarde mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je betalingsvoorwaarde zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use default price list group mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen prijslijstgroep mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je prijslijstgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Value for the default payment method id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betaalmethode mee. De waarde wordt alleen gebruikt als Make use of a default payment method id aan staat en je betaalmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
Value to use as default customer group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen klantgroep mee. De waarde wordt alleen gebruikt als Enable use of a default customer group aan staat en je klantgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betalingsvoorwaarde mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor betalingsvoorwaarden zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen prijslijstgroep mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor prijslijstgroepen zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betaalmethode mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor betaalmethodes zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
default payment terms id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betalingsvoorwaarde mee. De waarde wordt alleen gebruikt als Make use of a default payment terms id aan staat en je betalingsvoorwaarde zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
Enable URL Encoding of data in the endpoints of the source application
General flow settingHiermee codeer je de waarden in het adres (de URL) van de bronapplicatie, dus bij flows die gegevens ophalen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.
Enable URL Encoding of data in the endpoints of the target application
General flow settingHiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.
Enable URL encoding of data in endpoints
General flow settingZet URL-codering aan voor waarden die APIcenter in de URL van een verzoek aan HubSpot zet. Dit voorkomt fouten met speciale tekens zoals spaties, schuine strepen of ampersands. Bij HubSpot staan zoekwaarden zoals een e-mailadres, SKU of dealnaam in de inhoud van het verzoek en niet in de URL; in de URL staan alleen ID's en objecttypes. Je hebt dit daarom zelden nodig. Dit is de hoofdschakelaar: waarden worden alleen gecodeerd als je ook Enable URL Encoding of data in the endpoints of the source application (bij ophalen) of Enable URL Encoding of data in the endpoints of the target application (bij versturen) aanzet. Standaard staat dit uit.
Use administration mapping table
General flow settingDeze instelling heeft geen effect voor HubSpot. De data die APIcenter met HubSpot uitwisselt, heeft geen administratieveld, dus er valt niets te mappen. Laat deze instelling uit staan (standaard).
What to do with a value that cannot be mapped using the mapping table
General flow settingDeze instelling heeft geen effect voor HubSpot, omdat de data die APIcenter met HubSpot uitwisselt geen administratieveld heeft. Laat hem staan zoals hij is.
Default customer sales vat code id
Ledger SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen btw-code voor verkoop bij de klant mee. De waarde wordt alleen gebruikt als Enable the use of a default customer sales vat code id aan staat en je btw-code voor verkoop bij de klant zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
Enable the use of a default customer sales vat code id
Ledger SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen btw-code voor verkoop bij de klant mee. Je hebt hem alleen nodig als je btw-code voor verkoop bij de klant zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Force the usage of the customer sales vat code id
Ledger SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen btw-code voor verkoop bij de klant meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je btw-code voor verkoop bij de klant zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use default customer sales vat code id mapping table
Ledger SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen btw-code voor verkoop bij de klant mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je btw-code voor verkoop bij de klant zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Deze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen btw-code voor verkoop mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor btw-codes voor verkoop bij de klant zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
Deze instelling heeft voor HubSpot geen effect. De HubSpot-flows gebruiken geen betaaljournaal en de standaard data mapping stuurt er geen mee. Je kunt hem laten staan zoals hij is.
Notifications Email address
NotificationsVul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.
Notifications Slack webhook
NotificationsVul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. Er is geen standaardwaarde.
Notifications frequency
NotificationsKies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.
Receive Notifications
NotificationsZet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.
Maximum number of pages to retrieve
Run behaviourDeze instelling heeft voor HubSpot in de praktijk geen effect. De HubSpot-flows vragen per run één lijst op met een eigen limiet (bij ophalen is dat Amount to process) en lezen geen extra pagina's. De standaardwaarde is 20; je hoeft dit niet aan te passen.
Use page size
Run behaviourDeze instelling heeft voor HubSpot in de praktijk geen effect. De HubSpot-flows bepalen zelf hoeveel records ze per verzoek opvragen: bij ophalen is dat Amount to process. De standaardwaarde is 50; je hoeft dit niet aan te passen.
Enable the use of a default tax id
Tax & Tax RatesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Het btw-bedrag wordt berekend uit de bedragen in de data of, als het tarief daar niet in staat, uit Default tax rate prices. Laat deze instelling uit staan (standaard): staat hij aan zonder waarde bij Value for the default tax id (exclude '%'), dan stopt de flow met een foutmelding.
Force the use of the default tax id
Tax & Tax RatesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Laat deze instelling uit staan (standaard).
Use default tax id mapping table
Tax & Tax RatesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, dus er valt niets te mappen. De standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Je hebt de mappingtabel alleen nodig als je een btw-klasse zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Value for the default tax id (exclude '%')
Tax & Tax RatesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Je hebt dit veld alleen nodig als je een btw-klasse zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
Deze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor btw-klassen zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.