Alles over HubSpot

HubSpot: Producten ophalen uit HubSpot

Haal producten op uit HubSpot, met SKU, naam, omschrijving en prijs, en stuur ze door naar je webshop of een andere applicatie.

Bijgewerkt op 9 november 2026

Deze flow haalt producten op uit HubSpot en stuurt ze naar een andere applicatie, bijvoorbeeld een webshop. Gebruik deze flow als HubSpot het leidende systeem is voor je producten.

Zo werkt het

  • APIcenter haalt alleen producten op die zijn gewijzigd na de ingestelde datum, de oudste wijziging eerst. Per run haalt APIcenter maximaal het ingestelde aantal op, standaard 10. Na elke run zet APIcenter de datum op de wijzigingsdatum van het laatste product. Zet je de datum terug, dan haalt APIcenter producten opnieuw op.
  • Standaard stuurt APIcenter de SKU (hs_sku) als productcode, de naam, de omschrijving, de prijs en het btw-bedrag mee. Meer velden voeg je toe onder Data mapping.
  • Heeft een product een afbeeldings-URL in het veld hs_images, dan gebruikt APIcenter die als afbeelding van het product.
  • Varianten verwerkt APIcenter alleen als je de producteigenschap voor het hoofdproduct instelt. Een product waarvan die eigenschap de SKU van een ander product bevat, is een variant van dat product. Laat je de eigenschap leeg, dan verwerkt APIcenter alle producten als losse producten.
  • Kenmerken en attributen komen uit twee eigenschapsgroepen in HubSpot: de groep voor kenmerken en de groep voor attributen. Elke eigenschap in zo'n groep is een kenmerk of attribuut, met de label van de gekozen optie als waarde. Dit werkt alleen als je ook de eigenschap voor het hoofdproduct hebt ingesteld.

Wat je eerst nodig hebt

  • HubSpot is gekoppeld aan APIcenter. Zie HubSpot koppelen aan APIcenter.
  • Voor varianten: een producteigenschap in HubSpot waarin de SKU van het hoofdproduct staat.
  • Voor kenmerken en attributen: eigenschapsgroepen in HubSpot met de eigenschappen die je wilt doorgeven.
  • De andere applicatie van de integratie kan producten ontvangen.

Tips

  • Ontbreekt een product in het doelsysteem? Controleer of het is gewijzigd na de ingestelde datum. Zo niet, zet de datum dan terug.
  • De standaard data mapping bevat geen voorraad en geen categorieën. Heb je die nodig, voeg ze dan toe onder Data mapping.
  • Bestaat de producteigenschap voor het hoofdproduct niet in HubSpot, dan stopt de flow met een foutmelding. Controleer de naam.

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.

Deze instelling heeft geen effect. APIcenter gebruikt hem in de HubSpot-flows niet. Wil je extra productvelden uit HubSpot ophalen, koppel ze dan onder Data mapping. Laat het veld leeg.

Use custom Product properties

Custom Properties

Deze instelling heeft geen effect. APIcenter gebruikt hem in de HubSpot-flows niet. Wil je extra productvelden uit HubSpot ophalen, koppel ze dan onder Data mapping. Laat deze instelling uit staan.

Hiermee 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.

Zet 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 setting

Deze 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).

Deze instelling heeft geen effect voor HubSpot, omdat de data die APIcenter met HubSpot uitwisselt geen administratieveld heeft. Laat hem staan zoals hij is.

Vul 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.

Vul 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

Notifications

Kies 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

Notifications

Zet 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.

Bepaalt 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.

De 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.

De 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.

De 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.

Amount to process

Run behaviour

Het maximale aantal contacten, producten of deals dat APIcenter per run uit HubSpot ophaalt. De standaardwaarde is 10; je kunt een getal van 1 tot en met 15 kiezen. APIcenter haalt de oudst gewijzigde records eerst op. Met een hoger aantal werk je een achterstand sneller weg, maar duurt elke run langer.

De datum en tijd vanaf wanneer APIcenter contacten (Get Customer) of producten (Get Product) uit HubSpot ophaalt. APIcenter haalt alleen records op die ná dit moment zijn gewijzigd, de oudste wijziging eerst. Na elke run zet APIcenter de datum op de wijzigingsdatum van het laatste opgehaalde record, dus je hoeft dit normaal niet aan te passen. Zet je de datum terug in de tijd, dan haalt APIcenter die records opnieuw op en stuurt ze opnieuw door. Standaard: 2025-01-01T00:00:00.

Last execution time

Run behaviour

Hier staat het moment waarop de flow voor het laatst is gestart. APIcenter vult dit zelf in na elke run en gebruikt het om te bepalen wanneer de flow weer mag draaien. Je hoeft dit normaal niet te wijzigen. De standaardwaarde is 1980-01-01T00:00:01: de flow heeft dan nog niet gedraaid.

Run at specific times

Run behaviour

Hier kies je vaste tijden van de dag waarop de flow ook moet starten. Je kunt meerdere tijden kiezen, in stappen van 15 minuten. Er is geen standaardwaarde.

Nog vragen?

Stel je vraag aan de supportassistent in je dashboard of maak een supportticket aan.

Naar support