Laatst bijgewerkt: 22 juli 2026
Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:
HubSpot en AWS S3 koppelen
- Klik in je HubSpot-account op het Marktplaats-pictogram
in de bovenste navigatiebalk en selecteer vervolgens HubSpot-marktplaats. - Zoek in de zoekbalk naar Amazon S3 en selecteer deze.
- Klik op 'Installeren'.
- Selecteer uw AWS IAM -rol en klik vervolgens op 'Installeren'.
- Klik op 'Volgende'.
- Voer de ARN-waarde van de AWS IAM-rol in het veld 'Role ARN ' in.
- Klik op 'Verbinden met Amazon S3'.
Configureer bucket-toegangsrechten
HubSpot heeft de volgende rechten nodig voor een AWS S3-bucket en -map om toegang te krijgen tot bestanden in de map en submappen:
- s3:GetBucketLocation
- s3:GetObject
- s3:GetObjectVersion
- s3:ListBucket
- s3:PutObject
- s3:DeleteObject
Nadat je de app hebt gekoppeld, verleen je HubSpot toestemming om gegevens te synchroniseren met je S3-bucket.
- Klik in je HubSpot-account op het
instellingen-pictogram in de bovenste navigatiebalk. Ga in het zijbalkmenu links naar Integraties > Verbonden apps. - Klik op Amazon S3.
- Klik in het rechterpaneel op Selecteren voor het Amazon S3-account waarmee u gegevens wilt synchroniseren.
- Klik op de pagina ‘Toestemmingen’ op ‘Kopiëren’ om het voorbeeld van het toestemmingsbeleid te kopiëren en dit toe te voegen aan de AWS IAM-rol die je eerder hebt aangemaakt. Vergeet niet het toestemmingsbeleid aan te passen met de namen van je buckets.
- Meld u aan bij de AWS Management Console.
- Klik op het startdashboard op Services > Beveiliging, identiteit en naleving > IAM.
- Klik in de linkerzijbalk op Accountinstellingen.
- Zoek in het gedeelte Security Token Service (STS) naar de AWS-regio die overeenkomt met de regio waarin uw AWS-account zich bevindt. Klik op de schakelaar om de regio te activeren.
- Klik in het linkerpaneel op 'Beleidsregels'.
- Klik op Beleid maken.
- Klik op het tabblad JSON op Nieuwe instructie toevoegen.
- Voeg het beleid toe dat u in stap 4 hebt gekopieerd. Dit beleid geeft HubSpot de benodigde machtigingen om gegevens te laden of te exporteren via één bucket en map.
- Zorg ervoor dat u <bucket> en <prefix> vervangt door uw daadwerkelijke bucketnaam en het voorvoegsel van het mappad. De Amazon Resource Names (ARN’s) voor buckets in overheidsregio’s hebben het voorvoegsel arn:aws-us-gov:s3:::.
- Door de voorwaarde s3:prefix in te stellen op ["*"] of ["<path> /*"], krijgt u respectievelijk toegang tot alle prefixen in de opgegeven bucket of tot het opgegeven pad in de bucket.
- Klik op 'Volgende'.
- Voeg in het gedeelte 'Controleren en aanmaken' de beleidsnaam en een optionele beschrijving toe.
- Klik op Beleid aanmaken.
Configureer de doelsbucket
- Terug op de pagina 'Toegangsrechten' in HubSpot voert u in het veld 'Bucket' de naam van de bucket in.
- Klik op 'Verbinding testen'.
- Als de verbindingstest is geslaagd, klik je op Volgende.
Configureer de synchronisatie
- Selecteer op de pagina 'Gegevensbron' de gegevens die je wilt synchroniseren.
- Schakel de selectievakjes in voor de objecten, koppelingen en gebeurtenissen die u vanuit HubSpot naar Amazon S3 wilt synchroniseren.
- Klik op 'Volgende'.
- Klik op de pagina 'Details' op het vervolgkeuzemenu 'Synchronisatiefrequentie' en selecteer de frequentie waarmee je de gegevens van HubSpot naar Amazon S3 wilt synchroniseren.
- Klik op 'Synchronisatie starten'.
De synchronisatie beheren
Nadat u een synchronisatie hebt ingesteld en de gegevens beginnen te synchroniseren van HubSpot naar Amazon S3, kunt u de status bekijken, fouten opsporen, instellingen bijwerken of de synchronisatie archiveren.
De synchronisatie bekijken en beheren:
- Klik in je HubSpot-account op Meer en navigeer vervolgens naar Gegevensbeheer > Gegevensintegratie. Als Meer niet in je account verschijnt, navigeer dan direct naar Gegevensbeheer > Gegevensintegratie.
- Ga naar het tabblad 'App-synchronisaties' en zoek uw Amazon S3-synchronisatie in de tabel.
- Controleer de synchronisatiestatus:
-
- Synchronisatie: er wordt momenteel gesynchroniseerd.
- Gesynchroniseerd: de laatste synchronisatie is succesvol voltooid.
- Mislukt: er is een fout opgetreden tijdens de laatste synchronisatie.
- Gearchiveerd: de synchronisatieconfiguratie is verwijderd.
- Klik op de naam van de synchronisatie om meer details te bekijken, waaronder records die succesvol zijn gesynchroniseerd en records die zijn mislukt.
Om een synchronisatie te bewerken of te verwijderen:
- Klik in de tabel op de Amazon S3 -synchronisatie.
- Klik rechtsboven op het vervolgkeuzemenu 'Acties' en selecteer vervolgens een van de volgende opties:
-
- Synchronisatie bewerken: de synchronisatie-instellingen bijwerken.
- Synchronisatie archiveren: verwijder de synchronisatieconfiguratie.
Gegevensformaat voor synchronisatie tussen HubSpot en Amazon S3
Beschikbare gegevens voor synchronisatie
U kunt de volgende gegevens van HubSpot naar AWS S3 synchroniseren:
- Objecten: standaard- en aangepaste objecten, zoals contactpersonen, bedrijven, tickets of producten.
- Records: afzonderlijke objectrecords.
- Eigenschappen: eigenschappen en hun waarden in de objectrecords, inclusief de eigenschapsgeschiedenis.
- Koppelingen: alle koppelingstypen en gekoppelde records.
- Gebeurtenissen: geselecteerde standaard HubSpot-gebeurtenissen en aangepaste gedragsgebeurtenissen, inclusief geselecteerde gebeurteniseigenschappen.
Objectgegevens van verschillende typen worden op twee manieren georganiseerd en zijn op twee manieren beschikbaar:
- Individueel: elk objecttype wordt in een eigen tabel opgeslagen en bevat uitsluitend records van hetzelfde objecttype. Zo bevat bijvoorbeeld
objects_contactsuitsluitend contactrecords. - Gecombineerd: alle records voor alle objecttypen worden samengevoegd tot één databaseobject. Bij het uitvoeren van een query moet u daarom een filter opgeven zoals “WHERE objectTypeId=’0-1’
Aangepaste objecten krijgen bij het aanmaken een ID toegewezen en worden aangeduid als 2-unique_ID. Bijvoorbeeld: 2-12345.
S3-mapstructuur
HubSpot schrijft elke succesvolle synchronisatie naar een door HubSpot beheerd voorvoegsel in uw Amazon S3-bucket volgens de volgende structuur:
s3://<bucket-name>/hubspot-dataout/<account-id>/<run-id>/<table-name>/<file-name>
Bijvoorbeeld:
s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/OBJECT_WITH_OBJECT_PROPERTIES/part-000.parquet
s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/EVENTS_VISITED_PAGE/part-000.parquet
s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/ASSOCIATIONS_CONTACTS_TO_COMPANIES/part-000.parquet
Bij elke synchronisatie wordt een nieuwe map run-id aangemaakt. HubSpot verwijdert geen gegevens van eerdere synchronisaties.
Als je oudere synchronisaties automatisch wilt verwijderen, configureer dan een Amazon S3-levenscyclusbeleid voor de bucket of het prefix.
HubSpot genereert bestandsnamen voor elke synchronisatierun, en deze bestandsnamen kunnen per synchronisatierun verschillen. Configureer downstream-processen niet zo dat ze afhankelijk zijn van specifieke bestandsnamen. Lees in plaats daarvan alle bestanden in de map met de juiste tabelnaam voor de exportrun die je wilt verwerken.
Objectbestanden
Als je objectgegevens selecteert, exporteert HubSpot de volgende mappen.
OBJECTS_PROPERTIES
Eén rij per waarde van een objecteigenschap.
| Kolomnaam |
Type |
Beschrijving |
|---|---|---|
| OBJECTTYPEID |
Tekst |
De ID van het objecttype. Voor contactpersonen wordt bijvoorbeeld 0-1 gebruikt. |
| OBJECTID |
Getal |
De ID van het record. |
| NAME |
Tekst |
De eigenschapsnaam. |
| WAARDE |
Tekst |
De waarde van de eigenschap. |
| UPDATEDAT |
Tijdstempel |
De datum en tijd waarop de eigenschapswaarde voor het laatst is bijgewerkt in HubSpot. |
| INGESTEDAT |
Tijdstempel |
De datum en tijd waarop de gegevens voor het laatst in de exportbron zijn ingelezen. |
OBJECT_WITH_OBJECT_PROPERTIES
Eén rij per objectrecord, waarbij de geselecteerde eigenschapswaarden zijn gegroepeerd in één kolom PROPERTIES.
| Kolomnaam |
Type |
Beschrijving |
|---|---|---|
| OBJECTTYPEID |
Tekst |
De ID van het objecttype. Voor contactpersonen wordt bijvoorbeeld 0-1 gebruikt. |
| OBJECTID |
Getal |
De ID van het record. |
| PROPERTIES |
Object of JSON |
De geselecteerde eigenschapswaarden van het record. |
| UPDATEDAT |
Tijdstempel |
De datum en tijd waarop de geselecteerde eigenschappen van het record voor het laatst zijn bijgewerkt in HubSpot. |
| INGESTEDAT |
Tijdstempel |
De datum en tijd waarop de gegevens voor het laatst in de exportbron zijn ingelezen. |
Om een specifiek objecttype uit deze map te lezen, filtert u op OBJECTTYPEID.
Koppelingsbestanden
Als je associatiegegevens selecteert, synchroniseert HubSpot zowel de associatierecords als de associatiedefinities.
ASSOCIATIONS
Eén rij per geselecteerde associatie tussen twee objectrecords.
| Kolomnaam |
Type |
Beschrijving |
|||
|---|---|---|---|---|---|
| COMBINEDASSOCIATIONTYPEID |
Tekst |
De unieke identificatiecode voor de associatiedefinitie. |
|||
| ASSOCIATIONCATEGORY |
Tekst |
De herkomst van het associatietype. Mogelijke waarden zijn onder andere `HUBSPOT_DEFINED`, `USER_DEFINED` of `INTEGRATOR_DEFINED`. |
|||
| ASSOCIATIONTYPEID |
Getal |
De identificatiecode voor de associatiedefinitie binnen de betreffende categorie. |
|||
| FROMOBJECTID |
Getal |
De ID van het bronobjectrecord. |
|||
| TOOBJECTID |
Getal |
De ID van het doelobjectrecord. |
|||
| INGESTEDAT |
Tijdstempel |
De datum en tijd waarop de gegevens voor het laatst in de exportbron zijn ingelezen. |
|||
ASSOCIATION_DEFINITIONS
Eén rij per geselecteerde associatiedefinitie.
| Kolomnaam |
Type |
Beschrijving |
|---|---|---|
| COMBINEDASSOCIATIONTYPEID |
Tekst |
De unieke identificatiecode voor de associatiedefinitie. |
| CATEGORY |
Tekst |
De herkomst van het associatietype. Mogelijke waarden zijn onder andere `HUBSPOT_DEFINED`, `USER_DEFINED` of `INTEGRATOR_DEFINED`. |
| ID |
Getal |
De identificatiecode voor de associatiedefinitie binnen de betreffende categorie. |
| FROMOBJECTTYPEID |
Tekenreeks |
De ID van het bronobjecttype. |
| TOOBJECTTYPEID |
String |
De ID van het doelobjecttype. |
| NAME |
Tekst |
De naam van de associatiedefinitie. |
| LABEL |
Tekst |
Het label van de associatiedefinitie. |
| INGESTEDAT |
Tijdstempel |
De datum en tijd waarop de gegevens voor het laatst in de exportbron zijn ingelezen. |
| ISMAINASSOCIATIONDEFINITION |
Booleaanse waarde |
Geeft aan of HubSpot deze associatiedefinitie weergeeft als de primaire associatie bij gekoppelde records. |
ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>
Voor geselecteerde koppelingsparen synchroniseert HubSpot ook mappen voor specifieke koppelingsparen, zoals ASSOCIATIONS_CONTACTS_TO_COMPANIES. Deze mappen bevatten koppelingsrecords en de bijbehorende definitie-metadata.
| Kolomnaam |
Type |
Beschrijving |
|---|---|---|
| COMBINEDASSOCIATIONTYPEID |
Tekst |
De unieke identificatiecode voor de associatiedefinitie. |
| ASSOCIATIONCATEGORY |
Tekst |
De herkomst van het associatietype. Mogelijke waarden zijn onder andere HUBSPOT_DEFINED, USER_DEFINED of INTEGRATOR_DEFINED. |
| ASSOCIATIONTYPEID |
Getal |
De identificatiecode voor de associatiedefinitie binnen de betreffende categorie. |
| [FROMOBJECTTYPE]_OBJECTID |
Getal |
De ID van het bronobjectrecord. Bijvoorbeeld CONTACT_OBJECTID. |
| [TOOBJECTTYPE]_OBJECTID |
Getal |
De ID van het doelobjectrecord. Bijvoorbeeld: COMPANY_OBJECTID. |
| INGESTEDAT |
Tijdstempel |
De datum en tijd waarop de gegevens voor het laatst in de exportbron zijn ingelezen. |
| TOOBJECTTYPEID |
Tekenreeks |
Het ID van het doelobjecttype. |
| FROMOBJECTTYPEID |
Tekst |
De ID van het bronobjecttype. |
| NAME |
Tekst |
De naam van de associatiedefinitie. |
| LABEL |
Tekst |
Het label van de associatiedefinitie. |
| ISMAINASSOCIATIONDEFINITION |
Booleaanse waarde |
Geeft aan of HubSpot deze associatiedefinitie weergeeft als de primaire associatie bij gekoppelde records. |
Gebeurtenisbestanden
Als je gebeurtenisgegevens selecteert, exporteert HubSpot één map voor elk gebeurtenistype. Mapnamen hebben de indeling EVENTS_<EVENT_NAME>, zoals EVENTS_VISITED_PAGE.
Elke gebeurtenismap bevat standaardgebeurteniskolommen en een kolom voor elke gebeurteniseigenschap die tijdens de configuratie is geselecteerd.
| Kolomnaam |
Type |
Beschrijving |
|---|---|---|
| EVENTTYPEID |
Tekst |
De ID van het gebeurtenistype. |
| ID |
String |
De unieke gebeurtenis-ID. |
| OBJECTTYPEID |
Tekenreeks |
De ID van het objecttype dat aan de gebeurtenis is gekoppeld. |
| OBJECTID |
Getal |
Het ID van het objectrecord dat aan de gebeurtenis is gekoppeld. |
| INGESTEDAT |
Tijdstempel |
De datum en tijd waarop de gebeurtenis in de exportbron is opgenomen. |
| OCCURREDATDATEINT |
Getal |
De datum van de gebeurtenis als geheel getal in de indeling JJJJMMDD. |
| OCCURREDAT |
Tijdstempel |
De datum en tijd waarop de gebeurtenis plaatsvond. |
| PROPERTY_<PROPERTY_NAME> |
Tekst |
Een geselecteerde gebeurteniseigenschap. Een eigenschap met de naam page_title wordt bijvoorbeeld geëxporteerd als PROPERTY_PAGE_TITLE. |
