Ein HubSpot-Import wirkt auf den ersten Blick einfach: Datei auswählen, Spalten zuordnen, Import starten. In der Praxis entstehen die teuersten Fehler jedoch vor dem Upload. Wenn ein Unternehmen Kontakte, Firmen, Deals oder Tickets aus einem Altsystem übernimmt, entscheidet nicht die CSV-Datei über den Erfolg, sondern das fachliche Datenmapping dahinter.
Die zentrale Frage lautet: Welche Information soll in welchem HubSpot-Objekt landen, wie werden bestehende Datensätze erkannt und welche Beziehungen müssen zwischen den Objekten erhalten bleiben? Wer diese Fragen erst im Importdialog beantwortet, testet häufig bereits mit produktiven Daten. Das kann zu Dubletten, falschen Zuordnungen und schwer nachvollziehbaren Reports führen.
Für mittelständische Unternehmen ist deshalb ein Import nicht nur ein technischer Upload, sondern ein kleiner Implementierungsprozess. Er sollte wie eine kontrollierte Datenänderung behandelt werden.
Vor der Dateivorbereitung sollte feststehen, welche Geschäftsobjekte in HubSpot abgebildet werden. Ein einfaches Szenario könnte so aussehen:
Diese Zuordnung klingt selbstverständlich, ist es aber nicht immer. In vielen Quellsystemen stehen Kunden, Lieferstellen, Abteilungen und Ansprechpartner in einer gemeinsamen Tabelle. HubSpot benötigt dagegen eine Entscheidung darüber, welche Zeile ein Kontakt ist, welche Zeile ein Unternehmen ist und ob ein Vorgang als Deal, Ticket oder nur als Aktivität übernommen werden soll.
Ein gutes Zielbild beantwortet außerdem, ob mehrere Datensätze desselben Typs zulässig sind. Bei Unternehmensgruppen kann beispielsweise eine Zentrale mit mehreren Standorten fachlich anders modelliert werden als ein einzelner Datensatz mit mehreren Adressfeldern. Genau diese Modellentscheidung beeinflusst später Zuordnungen, Segmentierung und Reporting.
Der wichtigste technische Begriff beim Import ist der eindeutige Identifikator. HubSpot nutzt ihn, um bestehende Datensätze zu erkennen, Aktualisierungen durchzuführen, Dubletten zu vermeiden und Beziehungen herzustellen.
Für Kontakte ist typischerweise die E-Mail-Adresse ein möglicher Identifikator, für Unternehmen die Unternehmensdomain. Alternativ kann die HubSpot Record ID verwendet werden. Für verschiedene Objekte sind auch benutzerdefinierte Eigenschaften mit eindeutigen Werten möglich. Entscheidend ist nicht, ob eine Spalte im Quellsystem „Kundennummer“ heißt, sondern ob sie im Zielsystem eindeutig, dauerhaft und korrekt gepflegt ist.
Eine Kundennummer kann ein guter Schlüssel sein, wenn sie genau einem Zielobjekt entspricht und sich nicht ändert. Sie ist jedoch kein automatisch gültiger HubSpot-Identifikator. Dafür muss sie als eindeutige benutzerdefinierte Eigenschaft angelegt und im Import als solche verwendet werden.
Besonders kritisch ist die Vermischung von Identifikator und beschreibenden Feldern. „Firma“, „Kundenname“ oder „Dealname“ sehen zwar eindeutig aus, sind es aber oft nicht. Schreibweisen, Rechtsformen, Umfirmierungen oder mehrere Vorgänge mit demselben Namen führen schnell zu Fehlzuordnungen.
Ein CRM besteht nicht nur aus einzelnen Datensätzen. Sein Wert entsteht durch die Beziehungen zwischen Kontakten, Unternehmen, Deals, Tickets und Aktivitäten. Diese Beziehungen müssen deshalb bereits in der Quelldatei oder im Importkonzept nachvollziehbar sein.
Bei einem Kontakt-Unternehmen-Import braucht jede Kontaktzeile beispielsweise einen Wert, mit dem das richtige Unternehmen gefunden werden kann. Das kann die Unternehmensdomain, eine Record ID oder – je nach Aufbau – ein gemeinsamer Schlüssel sein. Bei Deals muss zusätzlich geklärt werden, welchem Unternehmen und welchen Kontakten der Deal zugeordnet wird.
Wenn zwei Dateien verwendet werden, benötigen sie eine gemeinsame Spalte. Diese Spalte darf nicht bloß ähnlich aussehen, sondern muss auf der gewählten Seite eindeutig sein. „Unternehmensname“ funktioniert nur dann zuverlässig, wenn jeder Wert eindeutig und konsistent ist. In vielen Fällen ist eine technische Kundennummer oder Domain robuster.
Beziehungslabels sind ein weiterer Prüfpunkt. Eine Zuordnung „Kontakt gehört zu Unternehmen“ ist nicht dasselbe wie „Kontakt ist Entscheider“ oder „Kontakt ist Rechnungsempfänger“. Solche Rollen sollten nur importiert werden, wenn sie fachlich sauber definiert und im Zielprozess tatsächlich genutzt werden.
Ein Import kann neue Datensätze anlegen, bestehende aktualisieren oder beides kombinieren. Diese Entscheidung sollte pro Objekt getroffen werden. Für einen initialen Datenbestand kann „Erstellen und aktualisieren“ sinnvoll sein. Für einen gezielten Korrekturlauf ist „Nur aktualisieren“ oft sicherer, weil unerwartete neue Datensätze verhindert werden.
Ebenso wichtig ist die Frage, welche bestehenden Werte überschrieben werden dürfen. Eine Quelldatei mit leeren Feldern darf nicht automatisch dazu führen, dass gepflegte CRM-Werte verloren gehen. Deshalb sollte für kritische Eigenschaften geprüft werden, ob bestehende Werte geschützt werden müssen.
Bei Aktivitäten gelten zusätzliche Einschränkungen. Bestehende E-Mails, Meetings, Notizen und Aufgaben lassen sich laut HubSpot-Dokumentation nicht einfach über einen Import aktualisieren. Sie können je nach Importtyp erstellt und mit Objekten verknüpft werden, sind aber nicht wie normale Stammdaten zu behandeln.
Ein sauberer Import startet mit einer kleinen Testmenge. Empfehlenswert ist ein repräsentativer Ausschnitt mit:
Nach dem Test sollten nicht nur die Anzahl neuer Datensätze und Fehler geprüft werden. Entscheidend ist eine fachliche Stichprobe: Wurde der Kontakt dem richtigen Unternehmen zugeordnet? Ist der Deal am richtigen Datensatz? Sind Eigentümer, Pipeline, Status und relevante Datumswerte korrekt? Werden die importierten Daten in Ansichten, Listen, Workflows und Reports wie erwartet verwendet?
Erst wenn diese Prüfung bestanden ist, sollte der vollständige Import erfolgen. Bei größeren Datenmengen ist es sinnvoll, die Reihenfolge zu planen: zuerst Stammdaten, danach Beziehungen und anschließend Aktivitäten oder ergänzende Objekte. So lassen sich Fehler leichter eingrenzen.
Der geführte Import ist für viele Szenarien ausreichend. Er stößt jedoch an Grenzen, wenn mehrere Quellsysteme synchronisiert werden sollen, komplexe Transformationsregeln nötig sind oder Daten regelmäßig und bidirektional fließen müssen. Dann sind Data Sync, eine Integrationsplattform oder die Imports API mögliche Alternativen.
Die API schafft mehr Kontrolle über Mapping, Importstatus und Automatisierung. Sie ersetzt aber nicht die fachliche Modellierung. Auch technisch sauber übertragene Daten bleiben problematisch, wenn Identifikatoren, Objektgrenzen oder Beziehungen falsch definiert wurden.
Behandle einen HubSpot-Import nicht als einmalige Excel-Aufgabe. Erstelle zuerst ein Mapping-Dokument mit Quellfeld, Zielobjekt, Zielproperty, Datentyp, Identifikator, Überschreibregel und Validierung. Definiere danach einen Testfall, der nicht nur den Idealfall abbildet.
Die wichtigste Entscheidung ist selten, welche Spalte welchem Feld entspricht. Wichtiger ist, welche Bedeutung ein Datensatz im Unternehmen besitzt und wie diese Bedeutung später in Marketing, Sales, Service und Reporting genutzt wird. Ein kontrollierter Import schafft dafür eine belastbare Grundlage. Ein schneller Upload ohne Zielbild verschiebt die Probleme dagegen nur in den laufenden CRM-Betrieb.
Stand: November 2026. Subscription- und Berechtigungsanforderungen können je nach Importfunktion, Association Labels und Portal-Konfiguration abweichen und sollten vor der Umsetzung im jeweiligen HubSpot-Account geprüft werden.