Laatst bijgewerkt: 20 november 2025
Voordat u gegevens importeert in HubSpot, dient u de volgende limieten en vereisten door te nemen. U kunt ook voorbeeldbestanden raadplegen of voorbeeldbestanden genereren om u op weg te helpen.
Raadpleeg dit artikel voor meer informatie over de importtool. Als uw bestand klaar is, leest u hier hoe u het kunt importeren.
Technische vereisten en beperkingen
Alle bestanden die in HubSpot worden geïmporteerd, moeten:- Een .csv-, .xlsx- of .xls-bestand zijn.
- Slechts één blad bevatten.
- Een koptekstrij bevatten waarin elke kolomkop overeenkomt met een eigenschap in HubSpot. De kolomkoppen kunnen in willekeurige volgorde worden geplaatst zonder dat dit invloed heeft op de import. U kunt controleren of er al een standaardeigenschap bestaat die overeenkomt met uw koptekst, of u kunt voorafgaand aan de import een aangepaste eigenschap aanmaken. Meer informatie over vereisten voor eigenschappen.
- Bevat minder dan 1000 kolommen.
- Wees UTF-8-gecodeerd als er vreemde tekens in voorkomen.
- Als je een Excel-bestand importeert:
- Bevat gegevens die binnen de maximale limieten van Excel -werkbladen en -werkmappen blijven.
- Bevat cellen in getalformaat bij het importeren van eigenschappen voor datum- en tijdselectie.
Er zijn aanvullende technische limieten voor de importtool, afhankelijk van je HubSpot-abonnement. Deze limieten omvatten de grootte en rijlimieten van een importbestand, evenals het aantal bestanden en rijen dat je per dag kunt importeren.
- Als je alleen de gratis tools of Smart CRM Professional of Enterprise tools van HubSpot gebruikt, kun je:
- Bestanden tot 20 MB importeren.
- Maximaal 50 importen per dag uitvoeren.
- Maximaal 500.000 rijen per dag importeren. Als u een bestand met meer dan 500.000 rijen importeert, duurt het meerdere dagen om dit te voltooien.
- Als je account een Starter-, Professional- of Enterprise- abonnement heeft, kun je:
- Bestanden tot 512 MB importeren.
- Tot 500 importen per dag uitvoeren.
- Tot 10.000.000 rijen per dag importeren, met een limiet van 1.048.576 rijen per bestand. Als u importeert via de import-API, kunt u tot 80.000.000 rijen per dag importeren.
Deze limieten gelden voor een voortschrijdende periode van 24 uur en worden niet op een bepaald tijdstip van de dag gereset. Lees meer over uw HubSpot-abonnement en de beperkingen daarvan.
Waarden opmaken
Voor elke rij van uw importbestand kunt u waarden toevoegen voor de eigenschapskolommen. De opmaak van een waarde is afhankelijk van het type eigenschapveld en het doel van de import.
Waarden opmaken op basis van het type eigenschapveld
Afhankelijk van het type eigenschapveld gelden er specifieke opmaakvereisten:
| Type veld | 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 de regels voldoen, anders worden ze niet geïmporteerd. |
| Datum- en tijdkiezer |
Tijdstempels kunnen worden toegevoegd als uu:mm (28/10/2020 14:30) in alle bestandstypen of als een UNIX-tijdstempel in milliseconden in CSV-bestanden of een Excel-bestand met cellen in de tekstgetalnotatie. Als u geen tijdstempel toevoegt, wordt de tijd standaard ingesteld op middernacht. |
| 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 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 (bijvoorbeeld Lifecycle stage, Industry) moeten de waarden overeenkomen met de interne waarde of het label in het Engels. |
| Bestand |
Om bestaande bestanden toe te voegen aan een bestandseigenschap, voegt u de bestands-ID toe als waarde. U vindt de ID van een bestand in het gedeelte Algemeen van de details van een bestand. |
| Meerdere selectievakjes |
Om meerdere waarden te importeren, voegt u een puntkomma toe tussen elke waarde zonder spaties (waarde 1;waarde 2). Deze eigenschapopties moeten vóór het importeren worden aangemaakt. Om waarden toe te voegen of toe te voegen, voegt u een puntkomma toe vóór de eerste waarde (;waarde 3;waarde 4). Hierdoor wordt de waarde toegevoegd in plaats van de bestaande eigenschapwaarde te overschrijven. Meer informatie over het importeren van meerdere selectievakjeswaarden. |
| Getal |
Formatteer de waarde op basis van het type getal dat is aangemaakt:
|
| Enkelvoudig selectievakje |
Maak een kolom voor het veld met één selectievakje en stel de waarde op elke regel in op True of Yes om weer te geven als Yes of aangevinkt in HubSpot, of False of No om weer te geven als No of niet aangevinkt in HubSpot. |
| Term-eigenschappen |
De regel-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 de standaardtermijnen ingesteld. |
| Tekst |
Als u validatieregelshebt ingesteld , 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 e-mailadressen voor contactpersonen of bedrijfsdomeinen
Als u contacten met meer dan één e-mailadres importeert, voeg dan een kolom Extra e-mailadressen toe met hun secundaire e-mailadressen. Als u bedrijven met meer dan één domeinnaam importeert, voeg dan een kolomExtra 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 contactpersonen of bedrijven aan te maken, kunt u het e-mailadres van een nieuwe contactpersoon of de bedrijfsdomeinnaam van een nieuw bedrijf niet instellen op een e-mailadres of domein dat al bestaat als extra e-mailadres/domein 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 binnen HubSpot, wordenbestaande eigenschapswaarden niet gewist door lege cellen. Om bestaande eigenschapswaarden in bulk te wissen, kunt u de waarden handmatig bewerken of de workflowactie Records bewerken gebruiken .Deal-medewerkers
Als je medewerkers aan een deal toevoegt via import, voeg dan een koptekstDealmedewerkers toe. Voor elke cel moet je twee of meer gebruikers opgeven, gescheiden door puntkomma's (bijvoorbeeld user1@example.com;user2@example.com).Producttermijn en factureringsfrequenties
Als u een Term-eigenschapwaarde importeert, kunt u de waarde in de kolom Term opmaken als een getal in maanden (bijvoorbeeld 10 voor 10 maanden), als PXM waarbij X het aantal maanden is (bijvoorbeeld P6M voor een termijn van 6 maanden) of als PXY waarbij X het aantal jaren is (bijvoorbeeld P1Y voor een termijn van 1 jaar).
Als u een eigenschapwaarde voor factureringsfrequentie importeert, gebruikt u maandelijks, jaarlijks of driemaandelijks als het product een terugkerend prijstype heeft. Laat de cel leeg als het product een eenmalige prijs heeft.
Vereiste eigenschappen
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 identificatiecode opnemen (bijv. record-ID, e-mailadres, domeinnaam van het bedrijf).
Hoeweldit niet verplicht is, kunt u voor elk object aanvullende eigenschappen importeren, waaronder aangepaste en standaardeigenschappen. Raadpleeg de standaardeigenschappen voor contactpersonen, bedrijven, deals, tickets, telefoongesprekken, e-mails, vergaderingen, notities en taken. U kunt ook alle eigenschappen en hun waarden bekijken in uw eigenschappeninstellingen.
- Contacten: ten minste één van de volgende: voornaam, achternaam of e-mailadres.
- Bedrijven: ten minste één van Naam of Bedrijfsdomeinnaam.
Let op: de eigenschap Bedrijfsdomeinnaam accepteert alleen waarden tot het topniveaudomein (bijv. .com, .edu). Waarden met strings erachter (bijv. .edu/home) worden automatisch verwijderd wanneer u importeert.
- Deals: als u nieuwe deals aanmaakt, dealnaam, pijplijn en dealfase.
- Tickets: als u nieuwe tickets aanmaakt, Ticketnaam, Pipeline en Ticketstatus.
- Afspraken: starttijd van de afspraak. De starttijd van de afspraak moet worden opgegeven als een datum-tijd-eigenschap.
- Cursussen: cursusnaam.
- Vermeldingen: 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, hoeveelheid, prijs en het bijbehorende record-ID of de naam van de deal. Voeg het product-ID toe als u het regelitem ook aan een product koppelt. Dit wordt tijdens het importeren 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 de activiteitsdatum op te nemen.
- E-mails: e-mailtekst en e-mailrichting.
- Vergaderingen: vergaderingsbeschrijving, starttijd van de vergadering en eindtijd van de vergadering. Bij het importeren van nieuwe vergaderingen wordt ook aanbevolen om de activiteitsdatum op te nemen. De waarden voor de starttijd, eindtijd en activiteitsdatum moeten worden opgemaakt als datum-tijd-eigenschappen.
- Notities: tekst van de notitie.
- Taken: Taaktitel en Vervaldatum. De vervaldatum moet worden opgegeven 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, zodat de datum en tijd waarop een activiteit heeft plaatsgevonden, worden gespecificeerd. Als u deze eigenschap niet opneemt, worden de waarden voor de activiteitsdatum automatisch ingesteld op de datum en tijd van het importeren.
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 een unieke identificatie-eigenschap voor elk object bevatten. Voor alle objecten kunt u bestaande records exporteren en de 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 de domeinnaam van het bedrijf gebruiken.
Als u meerdere objecten importeert en record-ID's opneemt, is het raadzaam om de kolomkoppen in het bestand te differentiëren, zodat de ID overeenkomt met het juiste object (bijvoorbeeld één kolom met de naam Record-ID - Contacten en een andere met de naam Record-ID - Bedrijven).
Let op: het volgende gedrag is van toepassing als e-mailadres of bedrijfsdomeinnaam in uw bestand zijn opgenomen:
- Als u een aangepaste unieke waarde-eigenschap gebruikt om contacten te ontdubbelen, moet de eigenschap E-mail nog steeds unieke waarden bevatten.
- Als u een aangepaste unieke waarde-eigenschap 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 meerdere bedrijven hetzelfde domein hebben, 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 opgegeven in HubSpot. Als u een secundair e-mailadres gebruikt en de kolom Record-ID niet opneemt in uw bestand, vervangt het secundaire e-mailadres het primaire e-mailadres niet. Als u echter zowel het secundaire e-mailadres als de Record-ID als kolommen in uw bestand opneemt, vervangt het secundaire e-mailadres het primaire e-mailadres.
Vereisten om records te koppelen
Koppelingen in één bestand importeren
In één bestand kunt u twee of meer records per rij koppelen. Voeg informatie over gekoppelde records en/of activiteiten toe in dezelfde rij en voeg een unieke identificatiecode toe voor elk object. Om één record te koppelen aan meerdere activiteiten of records van een ander object, voegt u de unieke identificatiecode van het record toe 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 identificatiegegevens (bijv. e-mail, bedrijfsdomeinnaam, record-ID) toevoegt, worden er bij het importeren dubbele records aangemaakt in plaats van dat ze aan hetzelfde record worden gekoppeld.
Als u dezelfde objectkoppelingen importeert, gelden er aanvullende vereisten.
Koppelingen in twee bestanden importeren
Om records van twee objecten in twee bestanden te koppelen, gebruikt u een gemeenschappelijke kolom om de records in elk bestand te verbinden. Raadpleeg de voorbeeldbestanden voor meer hulp bij het importeren en koppelen van records.
Koppelingen van hetzelfde object
U kunt één bestand importeren om records van hetzelfde object in bulk te koppelen. Tijdens het importproces moet u een selectievakje aanvinken om koppelingen van hetzelfde object op te nemen.
Voeg bij het instellen van uw bestand informatie over de gekoppelde records toe in dezelfde rij en voeg een unieke identificatiecode toe voor elk record. De volgende aanvullende vereisten zijn specifiek voor het importeren van dezelfde objecten:
- Ten minste één record in een recordpaar moet al in HubSpot aanwezig zijn voordat u kunt importeren. U kunt bijvoorbeeld een nieuw contact importeren en dit koppelen aan een bestaand contact, maar u kunt niet importeren om twee nieuwe contacten aan te maken en te koppelen.
- Bij het koppelen van bestaande contactpersonen/bedrijven kunt u alleen het primairee-mailadres/bedrijfsdomein als unieke identificatiecode gebruiken. Secundaire e-mailadressen of domeinen worden niet ondersteund.
- Als u meerdere records aan één record koppelt, scheidt u de unieke identificatiewaarden van de records met een puntkomma in dezelfde cel (bijvoorbeeld 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 hun e-mailwaarden worden gebruikt als unieke identificatiecode. 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 het importeren is voltooid, het gekoppelde record het label Parent krijgt en Rory het gekoppelde label Child.
Ouder/kind-koppelingen
Voor meer informatie over het maken van koppelingen tussen moeder- en dochterbedrijven via import, raadpleegt u het artikel over het importeren van dochterbedrijven.
Aangepaste associatielabels
Abonnement vereist Een Professional- of Enterprise- abonnement is vereist om aangepaste associatielabels te kunnen gebruiken.
Om associatielabels te importeren, voegt u een kolom Associatielabel toe. Deze kolom hoeft alleen te 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 associatielabels in HubSpot aanmaken voordat u ze importeert.
- Om een bedrijfsassociatie als primair in te stellen, voegt u de waarde Primair toe aan de kolom Associatielabel voor die rij.
- Om meerdere labels in te stellen om de relatie tussen twee records te beschrijven, kunt u meerdere associatielabelwaarden in één cel opnemen, gescheiden door een puntkomma (bijvoorbeeld Manager; Facturatiecontactpersoon).
- Als u associatielabels importeert in een import met meerdere bestanden, moet u de kolom Associatielabel en een unieke identificatiecode voor het object dat u associeert in hetzelfde bestand opnemen .
- Als u gekoppelde labels importeert:
- Voor objectoverschrijdende associaties neemt u slechts één van de labels op in de kolom 'Associatielabel '. De labels worden tijdens het importproces aan het juiste object toegewezen.
- Voor associaties binnen hetzelfde object krijgt het record in dekolom ' e geassocieerde [unieke identificatiecode]' het label dat tijdens het importproces is toegevoegd of 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.
