Alles over HubSpot
HubSpot: Producten naar HubSpot sturen
Stuur producten uit je webshop of PIM naar HubSpot, met SKU, naam, omschrijving, prijs en, als je dat instelt, varianten en kenmerken.
Bijgewerkt op 9 november 2026
Deze flow stuurt producten uit een andere applicatie, zoals een webshop of een PIM, naar HubSpot. APIcenter maakt producten aan en werkt ze bij.
Zo werkt het
- APIcenter zoekt het product in HubSpot op de SKU (
hs_sku). Bestaat het niet, dan maakt APIcenter het aan. - Bestaat het product al, dan werkt APIcenter het alleen bij als Update existing products aan staat. Staat dat uit (standaard), dan meldt de flow dat het product niet mag worden bijgewerkt.
- Bij een update bepaal je met Update product name en Update product description of de naam en de omschrijving worden overschreven.
- Standaard stuurt APIcenter de SKU, de naam, de omschrijving, de prijs en het btw-bedrag mee. Meer velden voeg je toe onder Data mapping.
- APIcenter stuurt geen afbeeldingen naar HubSpot.
- Varianten verwerkt APIcenter als je de producteigenschap voor het hoofdproduct instelt. De variant krijgt in die eigenschap de SKU van het hoofdproduct. Laat je de eigenschap leeg, dan verwerkt APIcenter het product als een los product.
- Kenmerken en attributen schrijft APIcenter naar eigenschappen in de groepen die je instelt: de groep voor kenmerken en de groep voor attributen. Stel je een groep niet in, dan verwerkt APIcenter die kenmerken of attributen niet.
- Bestaat een eigenschap of optie 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 of optie aan.
Wat je eerst nodig hebt
- HubSpot is gekoppeld aan APIcenter. Zie HubSpot koppelen aan APIcenter.
- Het product heeft een SKU. APIcenter herkent het product daaraan.
- Voor varianten: een producteigenschap in HubSpot voor de SKU van het hoofdproduct.
- Voor kenmerken en attributen: eigenschapsgroepen in HubSpot met de bijbehorende eigenschappen. Een optie kun je alleen toevoegen aan een eigenschap die HubSpot niet vergrendeld heeft.
Tips
- Zie je geen wijzigingen op een bestaand product? Controleer of Update existing products aan staat.
- Zie je geen afbeeldingen in HubSpot? Dat klopt: APIcenter stuurt ze niet mee.
- Volgens HubSpot kan het even duren voordat nieuwe records in zoekresultaten verschijnen. Stuur je hetzelfde product kort na elkaar twee keer, dan kan APIcenter het eerste 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 attribute set
Attributes & FeaturesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. APIcenter schrijft attributen naar de eigenschapsgroep (property group) die je instelt bij Property category name to use for attributes, en niet naar een attribuutset. De waarde wordt alleen gebruikt als je de attribuutset zelf koppelt aan een HubSpot-eigenschap in de Data mapping.
Default feature set
Attributes & FeaturesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. APIcenter schrijft kenmerken naar de eigenschapsgroep (property group) die je instelt bij Property category name to use for features, en niet naar een kenmerkenset. De waarde wordt alleen gebruikt als je de kenmerkenset zelf koppelt aan een HubSpot-eigenschap in de Data mapping.
Force the usage of the default attribute set id
Attributes & FeaturesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen attribuutset meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je attribuutset zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Force the usage of the default feature set id
Attributes & FeaturesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen kenmerkenset meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je kenmerkenset zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Make use of a default feature set id
Attributes & FeaturesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen kenmerkenset mee. Je hebt hem alleen nodig als je kenmerkenset 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.
Use attribute mapping table
Attributes & FeaturesGebruik een mappingtabel om de namen en waarden van attributen uit de andere applicatie te koppelen aan de namen en opties van HubSpot-eigenschappen. APIcenter zoekt de eigenschap in de groep die je instelt bij Property category name to use for attributes, op naam of label. Waarden die niet in de tabel staan, worden afgehandeld volgens What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.
Use attribute set mapping
Attributes & FeaturesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen attribuutset mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je attribuutset zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use feature mapping
Attributes & FeaturesGebruik een mappingtabel om de namen en waarden van kenmerken uit de andere applicatie te koppelen aan de namen en opties van HubSpot-eigenschappen. APIcenter zoekt de eigenschap in de groep die je instelt bij Property category name to use for features, op naam of label. Waarden die niet in de tabel staan, worden afgehandeld volgens What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.
Use feature set mapping
Attributes & FeaturesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen kenmerkenset mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je kenmerkenset zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
What to do with a value that cannot be mapped using the mapping table
Attributes & FeaturesHier kies je wat er gebeurt met een attribuut dat niet in de mappingtabel staat. Met Waarde gebruiken blijft de oorspronkelijke waarde behouden. Met Waarde negeren wordt het attribuut helemaal weggelaten. De standaardkeuze is Standaardwaarde gebruiken.
What to do with a value that cannot be mapped using the mapping table
Attributes & FeaturesHier kies je wat er gebeurt met een kenmerk dat niet in de mappingtabel staat. Met Waarde gebruiken blijft de oorspronkelijke waarde behouden. Met Waarde negeren wordt het kenmerk helemaal weggelaten. De standaardkeuze is Standaardwaarde gebruiken.
What to do with a value that cannot be mapped using the mapping table
Attributes & FeaturesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen attribuutset mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor attribuutsets 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
Attributes & FeaturesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen kenmerkenset mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor kenmerkensets zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
Default category name
CategoriesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen categorie mee. De waarde wordt alleen gebruikt als Enable use of default category aan staat en je categorie zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
Enable use of default category
CategoriesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De HubSpot-flows verwerken geen productcategorieën en de standaard data mapping stuurt geen categorie mee. Je hebt hem alleen nodig als je de categorie zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Force category on variant as parent
CategoriesDeze instelling heeft geen effect voor HubSpot. De HubSpot-flows verwerken geen productcategorieën, dus er is niets om van het hoofdproduct over te nemen. Laat hem uit staan (standaard).
Force use of default category
CategoriesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen categorie meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je categorie zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Set category on variant as parent
CategoriesDeze instelling heeft geen effect voor HubSpot. De HubSpot-flows verwerken geen productcategorieën, dus er is niets om van het hoofdproduct over te nemen. Laat hem uit staan (standaard).
Use Category mapping
CategoriesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen categorie mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je categorie 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 categorie mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor categorieën zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
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 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.
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).
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).
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.
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.
Enrichement level to use as default
Marketplace SettingsDeze instelling heeft geen effect voor HubSpot. APIcenter gebruikt hem niet in de HubSpot-flows, dus 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.
Create missing properties in the target system
Product SettingsBepaalt of APIcenter een eigenschap of een optie die niet in HubSpot bestaat, zelf aanmaakt. Staat dit uit (standaard), dan stopt de flow met een foutmelding als een eigenschap of optie ontbreekt. Staat dit aan, dan maakt APIcenter de eigenschap of optie aan in de groep die je hebt ingesteld. Een optie kan alleen worden toegevoegd aan een eigenschap die HubSpot niet vergrendeld heeft; anders volgt een foutmelding.
Only update existing variants and don't create new ones
Product SettingsDeze instelling heeft geen effect. APIcenter gebruikt hem in de HubSpot-flows niet: een variant die nog niet bestaat, wordt altijd aangemaakt. Je kunt hem laten staan zoals hij is. Standaard staat dit uit.
Property category name to use for attributes
Product SettingsDe naam van de eigenschapsgroep (property group) in HubSpot die de eigenschappen voor attributen bevat, zoals kleur of maat, waarmee varianten verschillen. Bij Get Product leest APIcenter elke eigenschap in deze groep als attribuut, met de label van de gekozen optie als waarde; dat werkt alleen als je ook de eigenschap voor het hoofdproduct hebt ingesteld. Bij Send Product schrijft APIcenter de attributen naar eigenschappen in deze groep. Laat je dit veld leeg, dan verwerkt APIcenter geen attributen.
Property category name to use for features
Product SettingsDe naam van de eigenschapsgroep (property group) in HubSpot die de eigenschappen voor kenmerken van een product bevat. Bij Get Product leest APIcenter elke eigenschap in deze groep als kenmerk, met de label van de gekozen optie als waarde; dat werkt alleen als je ook de eigenschap voor het hoofdproduct hebt ingesteld. Bij Send Product schrijft APIcenter de kenmerken naar eigenschappen in deze groep. Laat je dit veld leeg, dan verwerkt APIcenter geen kenmerken.
Property name or id of the property that holds the parent reference.
Product SettingsDe naam of het label van de producteigenschap in HubSpot waarin de SKU van het hoofdproduct staat. Bij Get Product behandelt APIcenter een product met een waarde in deze eigenschap als variant van het product met die SKU. Bij Send Product krijgt een variant de SKU van het hoofdproduct in deze eigenschap. Bestaat de eigenschap niet, dan stopt de flow met een foutmelding, tenzij Create missing properties in the target system aan staat. Laat je dit veld leeg, dan verwerkt APIcenter alle producten als losse producten, zonder varianten.
Skip negativity flip process
Product SettingsStandaard zet APIcenter negatieve bedragen bij prijzen, kortingen en belasting om naar positieve bedragen. Bedragen inclusief en exclusief belasting worden dan ook omgewisseld als de belasting negatief is. Zet je deze instelling aan, dan slaat APIcenter deze omzetting over en blijven negatieve waarden negatief. De standaardwaarde is uit.
Update existing products
Product SettingsBepaalt wat er gebeurt als een product met dezelfde SKU (hs_sku) al in HubSpot bestaat. Staat dit uit (standaard), dan werkt APIcenter het product niet bij en meldt de flow dat het product niet mag worden bijgewerkt. Staat dit aan, dan werkt APIcenter het bestaande product bij. Met Update product name, Update product description en Update product images bepaal je welke velden worden overschreven.
Update product description
Product SettingsBepaalt of bij het bijwerken van een bestaand product ook de omschrijving wordt bijgewerkt. Zet dit uit als je de omschrijving in de doeltoepassing zelf wilt beheren. Deze instelling is alleen te kiezen als Update existing products aan staat. Standaard staat dit aan.
Update product images
Product SettingsDeze instelling heeft voor HubSpot geen effect. APIcenter stuurt bij Send Product geen afbeeldingen naar HubSpot, ook niet als de data mapping afbeeldingen bevat. Je kunt hem laten staan zoals hij is.
Update product name
Product SettingsBepaalt of de titel van een bestaand product ook wordt bijgewerkt als het product wordt bijgewerkt. Deze instelling hoort bij Update existing products. Zet hem uit als je de waarde in de bestemming zelf wilt beheren en niet wilt dat APIcenter hem overschrijft. Standaard staat deze instelling aan.
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 warehouse
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De HubSpot-flows gebruiken geen magazijn en de standaard data mapping stuurt er geen mee. Je hebt hem alleen nodig als je magazijn 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 default warehouse
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen magazijn meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je magazijn zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use warehouse mapping table
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen magazijn mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je magazijn zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Value for the default warehouse id
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen magazijn mee. De waarde wordt alleen gebruikt als Enable the use of a default warehouse aan staat en je magazijn 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
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De HubSpot-flows gebruiken geen magazijn. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor magazijnen zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
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.