Laatst bijgewerkt: 14 april 2026
Controleer voordat u gegevens in HubSpot importeert of uw bestanden voldoen aan de vereiste indeling en technische limieten. Sommige limieten zijn afhankelijk van uw abonnement. Zorg dat u weet welke bestandstypen worden ondersteund, hoe u eigenschapswaarden moet structureren en opmaken, en hoeveel rijen en bestanden u binnen een bepaalde periode kunt importeren.
Lees vóór het importeren het artikel ‘Aan de slag met importeren’.
Technische vereisten en limieten
Alle bestanden die in HubSpot worden geïmporteerd, moeten:- Een .csv-, .xlsx- of .xls-bestand zijn.
- Slechts één werkblad bevatten.
- Een koptekstrij bevatten waarin elke kolomkop overeenkomt met een eigenschap in HubSpot. De kolomkoppen kunnen in willekeurige volgorde worden geordend zonder dat dit invloed heeft op het importeren. Je kunt controleren of er al een standaardeigenschap bestaat die overeenkomt met je koptekst, of een aangepaste eigenschap aanmaken voordat je gaat importeren. Lees meer over eigenschapseisen.
- Bevat minder dan 1.000 kolommen.
- Gebruik UTF-8-codering als het bestand tekens in een vreemde taal bevat.
- Als u een Excel-bestand importeert:
- Bevat gegevens die binnen de maximale limieten van Excel voor werkbladen en werkmappen blijven.
- Bevat cellen in de getalnotatie bij het importeren van eigenschappen van de datum- en tijdkiezer.
Afhankelijk van je HubSpot-abonnement gelden er aanvullende technische limieten voor de importtool. Deze limieten omvatten de grootte- en rijlimieten van een importbestand, evenals het aantal bestanden en rijen dat je per dag kunt importeren.
- Als je de gratis tools van HubSpot gebruikt, kun je:
- Bestanden tot 20 MB importeren.
- Maximaal 50 importen per dag uitvoeren.
- Per dag maximaal 500.000 rijen importeren. Bestanden met meer dan 500.000 rijen hebben meerdere dagen nodig om te voltooien.
- Maximaal 3 importen tegelijk starten. Maximaal 2 van deze importen mogen meer dan 10.000 rijen bevatten. Als je 4 of meer gelijktijdige importen start, worden deze in de wachtrij geplaatst.
- Als uw account een Smart CRM-abonnement of een Starter-, Professional- of Enterprise -abonnement heeft, kunt u:
- Bestanden tot 512 MB importeren.
- Tot 500 importen per dag voltooien.
- Tot 10.000.000 rijen per dag importeren, met een limiet van 1.048.576 rijen per bestand. Als u importeert via de imports-API, kunt u tot 80.000.000 rijen per dag importeren.
- Maximaal 3 importen tegelijk starten. Maximaal 2 van deze importen mogen meer dan 10.000 rijen bevatten. Als u 4 of meer gelijktijdige importen start, worden deze in de wachtrij geplaatst.
Deze limieten gelden voor een voortschrijdende periode van 24 uur en worden niet op een specifiek tijdstip van de dag gereset. Lees meer over jeHubSpot-abonnement en de bijbehorende beperkingen.
Eigenschapswaarden opmaken
Voor elke rij van je importbestand kun je waarden toevoegen voor de eigenschapkolommen. De opmaak van een waarde is afhankelijk van het type eigenschapsveld en het doel van de import.
Waarden opmaken op basis van
het
type eigenschapsveld
Afhankelijk van het type eigenschapsveld gelden er specifieke opmaakvereisten:
| Veldtype | Vereisten |
| Datumkiezer Datum- en tijdkiezer |
Maanden kunnen een getal, drie letters of een volledige naam zijn (10, OCT, Oct, OCTOBER, October), jaren kunnen twee of vier cijfers zijn (2023, 23) en scheidingstekens kunnen een schuine streep, koppelteken of punt zijn (10/28/2023, 10-28-2023, 10.28.2023). Geldige datumnotaties zijn dag maand jaar (bijv. 28/10/2023), maand dag jaar (bijv. 10-28-23) of jaar maand dag (bijv. 2023.OCT.28). Als u validatieregels hebt ingesteld, moeten uw geïmporteerde waarden aan deze regels voldoen, anders worden ze niet geïmporteerd. |
| Datum- en tijdkiezer |
Tijdstempels kunnen worden toegevoegd als Tijdzone-offsets ten opzichte van de tijdzone van uw account kunnen worden toegevoegd als |
| Duur |
Voor eigenschappen die een duur bevatten, zoals de eigenschap Gespreksduur, moeten uw waarden worden opgemaakt als een UNIX-tijdstempel in milliseconden. Lees meer over het opmaken van tijdstempelwaarden en het converteren van een datum naar het UNIX-formaat. |
| Opsomming |
De waarden in uw importbestand moeten overeenkomen met het label of de interne waarde van de gedefinieerde opties van de eigenschap. Voor standaard opsommingseigenschappen van HubSpot (bijv. Levenscyclusfase, Sector) moeten de waarden overeenkomen met de interne waarde of het label in het Engels. |
| Bestand |
Om bestaande bestanden toe te voegen aan een bestands-eigenschap, voeg je de bestands-ID toe als waarde. Je vindt de ID van een bestand in het gedeelte Algemeen van de bestandsdetails. |
| Meerdere selectievakjes |
Om meerdere waarden te importeren, voeg je een puntkomma toe tussen elke waarde zonder spaties (waarde 1;waarde 2). Deze eigenschapsopties moeten vóór de import worden aangemaakt. Om waarden toe te voegen of achteraan te plaatsen, voegt u een puntkomma toevóór de eerste waarde (;waarde 3;waarde 4). Hierdoor wordt de waarde achteraan toegevoegd in plaats van de bestaande eigenschapswaarde te overschrijven. Meer informatie over het importeren van meerdere selectievakjeswaarden. |
| Getal |
Geef de waarde op basis van het type getaleigenschap dat is aangemaakt:
|
| Enkelvoudig selectievakje |
Maak een kolom voor het veld met het enkele selectievakje en stel de waarde op elke regel in op TrueofYesom dit in HubSpot weer te geven als Yes of aangevinkt, of opFalseofNoom dit in HubSpot weer te geven als No of niet aangevinkt. |
| Term-eigenschappen |
De regelitem-eigenschap Term moet worden toegevoegd in ISO-8601-periodeformaten van PnYnMnD of PnW. Bijvoorbeeld P12M of P24M voor jaarlijkse termijnen. Als dit veld leeg wordt gelaten, worden standaardtermijnen ingesteld. |
| Tekst |
Als u validatieregels, moeten uw geïmporteerde waarden aan de regels voldoen, anders worden ze niet geïmporteerd. |
| Gebruiker (eigenaar) |
Om tijdens het importeren een eigenaar aan een record of activiteit toe te wijzen:
|
Extra contact-e-mailadressen of bedrijfsdomeinen
Als u contacten importeert met meer dan één e-mailadres, voeg dan een kolom 'Extra e-mailadressen' toe met hun secundaire e-mailadressen. Als u bedrijven importeert met meer dan één domeinnaam, voeg dan een kolom'Extra domeinen' toe met hun secundaire domeinen. Om meerdere e-mailadressen of domeinen in een cel op te nemen, scheidt u de waarden met puntkomma's (bijv. email@email.com; emailtwo@email.com).
Als u importeert om contacten of bedrijven aan te maken, kunt u het e-mailadres van een nieuw contact of de bedrijfsdomeinnaam van een nieuw bedrijf niet instellen op een e-mailadres of domein dat al een extra e-mailadres/domein is voor een ander record.
Lege cellen
De importtool negeert lege cellen in een spreadsheet, dus laat bij het importeren van nieuwe eigenschapsgegevens cellen leeg voor records zonder waarde voor de eigenschap. Als een bestaand record al een waarde voor de eigenschap heeft in HubSpot, zullen lege cellen de bestaande eigenschapswaarde niet wissen. Om bestaande eigenschapswaarden in bulk te wissen, kunt u de waarden handmatig bewerken of de workflowactie 'Records bewerken' gebruiken .Medewerkers aan een deal
Als je via een import medewerkers aan een deal toevoegt, neem dan een 'Medewerker aan deal '-kopregel op. Voor elke cel moet je twee of meer gebruikers opgeven, gescheiden door puntkomma's (bijv. user1@example.com;user2@example.com).Productlooptijd en factureringsfrequenties
Als u een eigenschapswaarde voor Looptijd importeert, kunt u de waarde in de kolom Looptijd opmaken als een getal in maanden (bijv. 10 voor 10 maanden), als PXM waarbij X het aantal maanden is (bijv. P6M, voor een looptijd van 6 maanden) of als PXYwaarbij X het aantal jaren is (bijv. P1Y, voor een looptijd van 1 jaar).
Als
u
een eigenschapswaarde voor de factureringsfrequentie
importeert
, gebruik
dan'maandelijks', 'jaarlijks' of 'driemaandelijks' als het product een terugkerend prijstype heeft. Laat de cel leeg als het product een eenmalige prijs heeft.
Neem vereiste eigenschappen op
Afhankelijk van welke objecten of activiteiten u importeert, zijn de volgende eigenschappen vereist om records aan te maken en moeten deze als kolomkoppen in uw bestanden worden opgenomen. Als u records bijwerkt, moet u een unieke identificatie opnemen (bijv. record-ID, e-mail, bedrijfsdomeinnaam).
Hoeweldit niet verplicht is, kunt u voor elk object aanvullende eigenschappen importeren, waaronder aangepaste en standaardeigenschappen. Raadpleeg de standaardeigenschappen voor contactpersonen, bedrijven, deals, tickets, gesprekken, e-mails, vergaderingen, notities en taken. U kunt ook alle eigenschappen en hun waarden bekijken in uw eigenschappeninstellingen.
- Contactpersonen: ten minste één van de volgende: Voornaam, Achternaam of E-mail.
- Bedrijven: ten minste één van Naam of Bedrijfsdomeinnaam.
Let op: de eigenschap Bedrijfsdomeinnaam accepteert alleen waarden tot aan het topleveldomein (bijv. .com, .edu). Waarden met tekstreeksen erachter (bijv. .edu/home) worden automatisch verwijderd wanneer u importeert.
- Deals: als u nieuwe deals aanmaakt,Dealnaam, Pipeline en Dealstadium.Pipeline enDealstadium moeten overeenkomen met bestaande opties in uw account en het Dealstadium moet een geldig stadium zijn in die pipeline.
- Tickets: als u nieuwe tickets aanmaakt, Ticketnaam, Pipeline en Ticketstatus.
- Afspraken: Start afspraak. De start van de afspraak moet worden opgemaakt als eendatum-tijd-eigenschap.
- Cursussen: Cursusnaam.
- Advertenties: Naam.
- Diensten: Naam, Pijplijn en Pijplijnfase.
- Producten: als u producten bijwerkt, Record-ID of SKU.
- Als u producten bijwerkt in een account met één valuta:Eenheidsprijs en Naam.
- Als u producten bijwerkt in een account met meerdere valuta's:Prijs [Valuta-afkorting] (bijv. Prijs USD) en Naam.
- Bestellingen: Naam, pijplijn en pijplijnfase.
- Winkelwagentjes: Naam.
- Regelitems: Naam, Aantal, Prijs ende Record-ID of Dealnaam van de bijbehorende deals. Voeg de Product-ID van het product toe als je het regelitem ook aan een product koppelt; deze wordt tijdens de import toegewezen als een eigenschap van het regelitem.
Let op: bij het importeren van regelitems met deals wordt het dealbedrag niet bijgewerkt. Om het bijbehorende dealbedrag bij te werken, kunt u de regelitems handmatig bewerken of de regelitems koppelen aan een deal in HubSpot.
- Gesprekken: gespreksnotities. Bij het importeren van nieuwe gesprekken wordt ook aanbevolen om Activiteitsdatumop te nemen.
- E-mails: E-mailteksten E-mailadres.
- Vergaderingen:Beschrijving van de vergadering, Starttijd van de vergadering en Eindtijd van de vergadering. Bij het importeren van nieuwe vergaderingen wordt ook aangeraden om Activiteitsdatumop te nemen. De waarden voor de starttijd, eindtijd en activiteitsdatum moeten worden opgemaakt als datum-tijd-eigenschappen.
- Notities: Notitietekst.
- Taken:Titel van de taakenVervaldatum. De vervaldatum moet worden opgemaakt als een datum-tijd-eigenschap.
Let op: hoewel dit niet verplicht is, wordt aanbevolen om de Activiteitsdatum op te nemen bij het importeren van nieuwe activiteiten om de datum en tijd aan te geven waarop een activiteit plaatsvond. Als u deze eigenschap niet opneemt, worden de waarden voor de Activiteitsdatum automatisch ingesteld op de datum en tijd van de import.
Vereisten voor het
bijwerken van
bestaande records of
het voorkomen van
duplicaten
Om bestaande records bij te werken en dubbele records te voorkomen, moeten uw bestanden voor elk object een unieke identificatie-eigenschap bevatten. Voor alle objecten kunt u bestaande records exporteren en het record-ID als unieke identificatie gebruiken , of een aangepaste eigenschap gebruiken die unieke waarden vereist. Voor contactpersonen kunt u ook E-mail gebruiken . Voor bedrijven kunt u ook Bedrijfsdomeinnaam gebruiken.
Als u meerdere objecten importeert en Record-ID's opneemt, wordt aanbevolen om de kolomkoppen in het bestand te differentiëren, zodat de ID bij het juiste object hoort (bijvoorbeeld één kolom met de naam Record-ID - Contactpersonen en een andere met de naam Record-ID - Bedrijven).
Let op: hetvolgende geldt als E-mail of Bedrijfsdomeinnaam in uw bestand zijn opgenomen:
- Als u een aangepaste eigenschap met unieke waarden gebruikt om contactpersonen te ontdubbelen, moet de eigenschap E-mail nog steeds unieke waarden bevatten.
- Als u een aangepaste eigenschap met unieke waarden gebruikt om bedrijven te ontdubbelen, hoeft de eigenschap Bedrijfsdomeinnaam geen unieke waarden te bevatten. Dit betekent dat u dubbele bedrijfsdomeinen kunt importeren. Als u niet wilt dat er meerdere bedrijven met hetzelfde domein zijn, moet u dubbele domeinen uit uw bestand verwijderen voordat u het importeert, of in plaats daarvan Bedrijfsdomeinnaam als uw unieke identificatie gebruiken.
- U kunt een secundair e-mailadres gebruiken als unieke identificatie voor bestaande contacten die een secundair e-mailadres hebben vermeld in HubSpot. Als u een secundair e-mailadres gebruikt en de kolomRecord-ID niet in uw bestand opneemt, zal het secundaire e-mailadres het primaire e-mailadres niet vervangen. Als u echter zowel het secundaire e-mailadres als de Record-ID als kolommen in uw bestand opneemt, zal het secundaire e-mailadres het primaire e-mailadres vervangen.
Vereisten voor het koppelen van records
Koppelingen importeren in één bestand
In één bestand kunt u twee of meer records per rij koppelen. Neem informatie over gekoppelde records en/of activiteiten op in dezelfde rij en voeg een unieke identificatie toe voor elk object. Om één record te koppelen aan meerdere activiteiten of records van een ander object, neemt u de unieke identificatie van het record op in meerdere rijen voor elk record dat u wilt koppelen.
Luke Danes is bijvoorbeeld manager bij Luke's Diner, maar aannemer bij The Dragonfly Inn. Om hem aan beide bedrijven te koppelen, moet u twee rijen voor Luke Danes opnemen met de kolommen E-mail (of Record-ID) en Bedrijfsdomeinnaam (of Record-ID) voor elk bedrijf.
Let op: als u geen unieke identificatiecodes (bijv. E-mail, Bedrijfsdomeinnaam, Record-ID) opneemt, zal de import dubbele records aanmaken in plaats van elk record aan hetzelfde record te koppelen.
Als u koppelingen tussen dezelfde objecten importeert, gelden er aanvullende vereisten.
Koppelingen in twee bestanden importeren
Om records van twee objecten in twee bestanden aan elkaar te koppelen, gebruikt u een gemeenschappelijke kolom om de records in elk bestand met elkaar te verbinden. Raadpleeg de voorbeeldbestanden voor meer hulp bij het importeren en koppelen van records.
Koppelingen van hetzelfde object
Je kunt één bestand importeren om records van hetzelfde object in bulk te koppelen. Tijdens het importproces moet je een selectievakje aanvinken om koppelingen van hetzelfde object op te nemen.
Neem bij het opzetten van je bestand informatie over de gekoppelde records op in dezelfde rij en voeg een unieke identificatietoe voor elk record. De volgende aanvullende vereisten zijn specifiek voor het importeren van hetzelfde object:
- Ten minste één record in een recordpaar moet al in HubSpot bestaan voordat u het importeert. U kunt bijvoorbeeld een nieuw contact importeren en dit koppelen aan een bestaand contact, maar ukunt nietimporteren om twee nieuwe contacten aan te maken en te koppelen.
- Bij het koppelen van bestaande contacten/bedrijven kun je alleen het primairee-mailadres/bedrijfsdomein gebruiken als unieke identificatiecode. Secundaire e-mailadressen of domeinen worden niet ondersteund.
- Als je meerdere records aan één record koppelt, scheid je de unieke identificatiewaarden van de records met een puntkomma in dezelfde cel (bijv.luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).
In het onderstaande voorbeeldbestand zijn Rory en Jackson nieuwe contactpersonen die worden gekoppeld aan unieke labels van bestaande contactpersonen, waarbij hune-mailwaardenals unieke identificatie worden gebruikt. Sookie is een bestaande contactpersoon die wordt gekoppeld aan twee bestaande contactpersonen met hetzelfde label. In de eerste rij maakt het koppelingslabel deel uit van een labelpaar, wat betekent dat zodra de import is voltooid, het gekoppelde record het label'Parent'krijgten Roryhet bijbehorende label'Child'.
Ouder/kind-koppelingen
Voor meer informatie over het maken van ouder-kind-koppelingen via import, zie het gedeelte over het importeren van dochterondernemingen.
Aangepaste koppelingslabels
Abonnement vereist Een Professional- of Enterprise-abonnement is vereist om aangepaste koppelingslabels te gebruiken.
Om associatielabels te importeren, voegt u een kolom 'Associatielabel'toe. Deze kolom moet alleen worden toegevoegd als u labels wilt toevoegen om associaties te beschrijven. Als u geen labels aan associaties hoeft toe te voegen, is de kolom niet vereist.
- U moet de koppelingslabels in HubSpot aanmaken voordat u ze importeert.
- Om een bedrijfsrelatie als primair in te stellen, voeg je de waarde Primair toe aan de kolom Relatielabelvoor die rij.
- Om meerdere labels in te stellen om de relatie tussen twee records te beschrijven, kun je meerdere waarden voor associatielabels in één cel opnemen, gescheiden door een puntkomma (bijv. Manager; Contactpersoon voor facturering).
- Als u associatielabels importeert via een import van meerdere bestanden, moet u de kolom Associatielabel en een unieke identificatiecode voor het object waarmee u de koppeling maakt in hetzelfde bestand opnemen .
- Als ugekoppelde labels importeert:
- Neem voor objectoverschrijdende koppelingen slechts één van de labels op in de kolom Associatielabel. De labels worden tijdens het importproces aan het juiste object toegewezen.
- Voor koppelingen binnen hetzelfde object krijgt het record in dekolom 'Gekoppeld [unieke identificatiecode] ' het label dat tijdenshet importproces is toegevoegdof in de labelkolom van het bestand is opgenomen. Het andere record in de rij krijgt het andere label in het paar.
Voorbeeldbestanden
Aan het begin van het importproces kunt u een voorbeeldbestand genereren met de vereiste eigenschappen voor de geselecteerde objecten en activiteiten. Als u meer voorbeelden met aanvullende eigenschappen wilt bekijken, raadpleeg
dan
dit artikel met voorbeeldbestanden.
Volgende stappen
Nu uw importbestand compleet is, volgt u de juiste importinstructies:
