Sauberer Export aus HubSpot: Was der native Export nicht liefert

Ein RevOps-Team führte eine mustergültige Migration durch. Vierzigtausend Kontakte wurden sauber exportiert, Unternehmen wurden abgeglichen, Deal-Phasen korrekt abgebildet. An day one im neuen CRM öffneten Reps ihre Deal-Datensätze und fanden keine verknüpften Kontakte. Kein einziger Deal-zu-Kontakt-Link hatte die Migration überlebt.

Der Schuldige war HubSpots nativer Export. Er exportiert Kontakte. Er exportiert Unternehmen. Er exportiert Deals. Aber er exportiert nicht die Verknüpfungen zwischen ihnen. Diese befinden sich in einer separaten Datenschicht, die das Standard-Export-Tool nicht berührt. Das Sales-Team verlor an day one den Pipeline-Kontext, weil niemand nach Verknüpfungen gefragt hatte.

Dieser Leitfaden beschreibt alles, was der UI-Export zurücklässt, und wie Sie es vor der Migration sichern.

---

Wie HubSpot-Daten unter der Oberfläche aussehen

HubSpot organisiert Daten in Objekte und Verknüpfungen. Beide zu verstehen ist der Unterschied zwischen einem vollständigen und einem kaputten Export.

Objekte:

• Kontakte: Einzelne Personen
• Unternehmen: Organisationen (HubSpots Äquivalent zu Accounts)
• Deals: Vertriebsmöglichkeiten in einer Pipeline
• Tickets: Support- oder Service-Datensätze
• Custom Objects: Alles, was Ihr Portal über die vier Standardobjekte hinaus aufgebaut hat

Verknüpfungen sind eine separate Datenschicht. Ein Kontakt kann gleichzeitig mit einem Unternehmen, einem Deal und einem Ticket verknüpft sein. Aber keiner dieser Links ist im Kontaktdatensatz selbst gespeichert. Sie sind im Verknüpfungsgraphen von HubSpot abgelegt. Wenn Sie einen Kontakt als CSV exportieren, kommen die Verknüpfungen nicht mit. Die HubSpot CRM Associations API-Dokumentation erläutert das vollständige Verknüpfungsobjektmodell und die programmatische Abfrage von Beziehungsdaten.

Timeline-Events sind die Aktivitätsaufzeichnung. Jede gesendete E-Mail, jeder protokollierte Anruf, jedes gebuchte Meeting und jede Formularübermittlung befinden sich in der Timeline eines Kontakts. Diese sind ebenfalls vom Kontaktdatensatz getrennt und erfordern andere Exportmethoden.

Diese Architektur zu kennen erklärt, warum ein dreistufiger Exportprozess notwendig und nicht optional ist. Sie prägt auch Ihren Ansatz für die Feldzuordnung zwischen HubSpot und Ihrem Zielsystem: Verknüpfungen sind eine separate Zuordnungsherausforderung gegenüber Objekteigenschaften.

---

Schritt 1: Nativer Export, was er abdeckt und wofür Sie ihn nutzen

HubSpots nativer Export (Kontakte exportieren, Deals exportieren usw.) liefert Ihnen flache CSVs Ihrer Objektdatensätze. Er ist zuverlässig für Datensatzanzahlen und Kerneigenschaften. Er ist der richtige Ausgangspunkt.

Was der native Export gut abdeckt:

• Alle Kontakteigenschaften (Standard und benutzerdefiniert)
• Alle Unternehmenseigenschaften
• Alle Deal-Eigenschaften einschließlich Pipeline und Phase
• Alle Ticket-Eigenschaften
• Werte benutzerdefinierter Eigenschaften auf jedem Objekt

Was bei jedem Export enthalten sein sollte:

Wenn HubSpot Sie auffordert, zu exportierende Eigenschaften auszuwählen, akzeptieren Sie nicht die Standardauswahl. Wählen Sie „Alle Eigenschaften" oder wählen Sie manuell jede gewünschte Eigenschaft aus. Standard-Exporte lassen benutzerdefinierte Eigenschaften oft weg, wenn Sie diese nicht explizit einschließen.

Was der native Export nicht abdeckt:

• Kontakt-zu-Unternehmen-Verknüpfungen
• Kontakt-zu-Deal-Verknüpfungen
• Deal-zu-Unternehmen-Verknüpfungen
• Mehrfach-Objekt-Verknüpfungen (ein Deal, der mit mehreren Kontakten verknüpft ist)
• Engagement-Datensätze (Anrufe, E-Mails, Meetings, Notizen)
• Custom-Object-Datensätze

Nutzen Sie den nativen Export, um Ihre Basis-Datensatzdateien zu erstellen. Verknüpfungen und Engagement-Historie behandeln Sie separat. Bestätigen Sie Ihren Umfang vorher anhand der Hinweise in Ihre Daten vorbereiten, bevor Sie irgendetwas migrieren. Die dort getroffenen Entscheidungen bestimmen, welche HubSpot-Eigenschaften tatsächlich relevant sind.

Vergleich der Exportmethoden:

---

Schritt 2: Verknüpfungen separat exportieren

HubSpots Verknüpfungsdaten erfordern entweder die API oder eine bewusste Exporteinstellung. Hier sind beide Optionen.

Option A: Verknüpfungsexport innerhalb von HubSpot verwenden

Beim Export von Kontakten suchen Sie im Export-Dialog nach der Option „Verknüpfte Datensätze einschließen". In einigen Portal-Versionen erlaubt HubSpot die Aufnahme von Unternehmensname und Deal-Name in den Kontaktexport. Prüfen Sie, ob Ihre Portal-Version das unterstützt. Falls ja, erspart Ihnen das einen API-Aufruf.

Beachten Sie jedoch: „Verknüpfte Namen einschließen" ist nicht dasselbe wie den vollständigen Verknüpfungsgraphen zu exportieren. Sie erhalten Company.Name und Deal.Name in der Kontaktzeile, aber keine ordentliche Many-to-Many-Zuordnung, welche Kontakte in welchen Deals sind.

Option B: Verknüpfungen über die HubSpot API abrufen

Die Associations API gibt alle Verknüpfungspaare für einen bestimmten Objekttyp zurück. Ein technisches Teammitglied oder eine RevOps-Person mit Erfahrung in API-Tools wie Postman kann diese programmatisch abrufen.

Die wichtigsten Endpunkte:

• GET /crm/v4/associations/contacts/companies/batch/read: Kontakt-zu-Unternehmen-Paare
• GET /crm/v4/associations/contacts/deals/batch/read: Kontakt-zu-Deal-Paare
• GET /crm/v4/associations/deals/companies/batch/read: Deal-zu-Unternehmen-Paare

Exportieren Sie diese als separate Dateien und behandeln Sie sie als Join-Tabellen. In Ihrem Zielsystem verwenden Sie diese, um Beziehungen wiederherzustellen, nachdem Sie Basisdatensätze importiert haben.

Wenn Sie keine Entwicklerressourcen haben:

Tools wie Coupler.io, Supermetrics und HubSpots eigenes Data-Sync-Feature können strukturierte Exporte einschließlich Verknüpfungsdaten ohne API-Arbeit bereitstellen. Diese sind langsamer und kosten manchmal extra, aber sie sind für nicht-technische Teams wirklich nützlich. Sobald Sie die Verknüpfungsdaten haben, ist Testen der Migration mit einem Schattenimport die Methode, um zu prüfen, ob die Verknüpfungen intakt sind, bevor Sie zur vollständigen Migration übergehen.

---

Schritt 3: Engagement- und Aktivitätshistorie exportieren

HubSpot bezeichnet protokollierte Aktivitäten als „Engagements" und speichert sie in einer Timeline, die vom Kontaktdatensatz getrennt ist. Diese Daten können nicht über den Standard-UI-Export exportiert werden. Die API ist erforderlich.

Was als Engagement-Daten gilt:

• Protokollierte Anrufe (mit Notizen/Ergebnis)
• Protokollierte E-Mails
• Gebuchte und abgeschlossene Meetings
• Manuell von Reps hinzugefügte Notizen
• Aufgaben mit Abschlussdaten
• Formularübermittlungen

Was die Timeline außerdem enthält (in der Regel überspringen):

• E-Mail-Öffnungs- und Klick-Events (automatisch von HubSpot-Tracking protokolliert)
• Seitenaufruf-Events
• Workflow-Einschreibungshistorie

Die erste Kategorie sind von Reps eingegebene Daten, echter Vertriebskontext. Die zweite Kategorie sind systemgenerierte Event-Daten. Bei den meisten Migrationen möchten Sie die erste und sollten die zweite überspringen. Hunderttausende von Seitenaufruf-Events zu migrieren erzeugt Rauschen im Zielsystem ohne jeden geschäftlichen Mehrwert.

API-Endpunkt:

GET /crm/v3/objects/engagements gibt Engagement-Datensätze mit ihrem Typ (CALL, EMAIL, MEETING, NOTE, TASK), verknüpften Kontakt-/Unternehmens-/Deal-IDs und dem Engagement-Inhalt zurück.

Praktische Lösung für nicht-technische Teams:

Wenn Sie nicht auf die API zugreifen können, dokumentieren Sie die Entscheidung explizit: Sie migrieren keine Engagement-Historie, und das HubSpot-Quellportal bleibt 90 Tage nach der Migration im read-only-Modus zugänglich, für alle, die historischen Kontext benötigen. Ein Forrester-Forschungsbericht zur CRM-Datenmigration stellt fest, dass die Vollständigkeit der Engagement-Historie zu den fünf wichtigsten Faktoren zählt, die die Adoption-Geschwindigkeit nach einem CRM-Wechsel bestimmen. Das ist eine legitime Geschäftsentscheidung. Nicht jede Migration muss die vollständige Engagement-Historie mitführen. Das Entscheidende ist, diese Wahl bewusst zu treffen und nicht erst nach go-live auf die Lücke zu stoßen. Für alles, was Sie nicht migrieren, beschreibt Langzeit-Archivierung von Legacy-CRM-Daten, wie Sie es zugänglich halten, ohne dauerhaft HubSpot-Lizenzen zu bezahlen.

---

Schritt 4: Custom Objects behandeln

Wenn Ihr HubSpot-Portal Custom Objects hat (häufig in Portalen, die für spezifische Branchen-Workflows angepasst wurden), erfordern diese Objekte einen eigenen Exportprozess.

So prüfen Sie, ob Ihr Portal Custom Objects hat:

Einstellungen, Objekte, Custom Objects. Wenn dort nichts steht, überspringen Sie diesen Abschnitt.

Custom Objects exportieren:

Custom Objects in HubSpot können nicht über den Standard-UI-Export exportiert werden. Optionen:

1. HubSpot API: Gleiches Muster wie bei Standardobjekten. Nutzen Sie GET /crm/v3/objects/{customObjectType} mit dem internen Namen des Custom Object.
2. HubSpot Data Sync: HubSpots natives Sync-Tool kann in Spreadsheets oder Datenbanken exportieren, einschließlich Custom Objects.
3. Drittanbieter-Konnektoren: Tools wie Airbyte oder Fivetran haben HubSpot-Konnektoren, die Custom Objects nativ handhaben.

Für die meisten Teams ohne dedizierten Data Engineer ist ein Drittanbieter-Konnektor der zuverlässigste Ansatz für Custom-Object-Exporte.

---

Schritt 5: Vollständigkeit prüfen, bevor Sie HubSpot verlassen

Beginnen Sie nicht mit der Bereinigung oder dem Import, bevor Sie verifiziert haben, dass der Export alles Nötige enthält. Eine 30-minütige Validierung jetzt verhindert wochenlange Abstimmung später.

Validierungs-Checkliste:

• Kontaktanzahl in CSV stimmt mit HubSpot-Kontaktgesamtzahl überein (Einstellungen, Kontostandards, Kontakte)
• Unternehmensanzahl in CSV stimmt mit HubSpot-Unternehmensgesamtzahl überein
• Deal-Anzahl in CSV stimmt mit HubSpot-Deal-Gesamtzahl überein (bei mehreren Pipelines nach Pipeline prüfen)
• Verknüpfungs-Exportdateien vorhanden für: Kontakt-Unternehmen, Kontakt-Deal, Deal-Unternehmen
• Definitionen benutzerdefinierter Eigenschaften exportiert (Einstellungen, Eigenschaften, Eigenschaftsliste separat exportieren)
• Engagement-Export deckt wichtige Typen ab: Anrufe, E-Mails, Meetings, Notizen
• DSGVO-/Opt-out-Felder im Kontaktexport enthalten (nach „E-Mail-Opt-out", „Rechtsgrundlage der Verarbeitung", „DSGVO-Einwilligung"-Felder suchen)
• Lifecycle-Stage-Feld im Kontaktexport enthalten

Stichproben-Verknüpfungscheck:

Wählen Sie 10 Deals aus Ihrem Export. Prüfen Sie für jeden Deal:

1. Stimmen die Kontakt-IDs in Ihrer Verknüpfungsdatei mit Kontakten in Ihrem Kontaktexport überein?
2. Stimmen die Unternehmens-IDs mit Unternehmen in Ihrem Unternehmensexport überein?
3. Zählen Sie die Kontakte pro Deal. Stimmt das mit der HubSpot-UI überein?

Inkonsistenzen bedeuten, dass Ihr Verknüpfungsexport unvollständig ist. Korrigieren Sie das vor der Bereinigung.

Vollständigkeit benutzerdefinierter Eigenschaften:

Exportieren Sie Ihre Eigenschaftsdefinitionen (Einstellungen, Eigenschaften, Herunterladen) und vergleichen Sie die Eigenschaftsnamen mit Ihren CSV-Spaltenüberschriften. Fehlende Spalten weisen auf Eigenschaften hin, die nicht im Export enthalten waren. Führen Sie den Export mit diesen Eigenschaften erneut durch.

---

Häufige Fehler

Kontakte ohne Unternehmen exportieren. Wenn Unternehmensdatensätze nicht in Ihrem Export enthalten sind, verliert jeder Kontakt seine Unternehmensverknüpfung. Exportieren Sie zuerst Unternehmen, dann Kontakte mit enthaltenem Company.Name.

Lifecycle-Stage-Verlauf verlieren. Das Lifecycle-Stage-Feld wird im Laufe der Zeit aktualisiert, aber HubSpot speichert nur den aktuellen Wert, nicht die Historie der Änderungen. Wenn die Lifecycle-Stage-Entwicklung für Ihre Zielsystem-Einrichtung wichtig ist, dokumentieren Sie die aktuellen Statuswerte zum Exportzeitpunkt. Die Historie lässt sich nicht wiederherstellen.

Fehlende Definitionen benutzerdefinierter Eigenschaften. Beim Import ins Zielsystem müssen Sie alle benutzerdefinierten Eigenschaften neu anlegen. HubSpot lässt Sie die Eigenschaftsdefinitionsliste exportieren (nicht nur die Werte). Laden Sie sie herunter. Das spart Stunden bei der Feldzuordnung.

DSGVO-Einwilligungsfelder vergessen. Wenn Ihr Portal E-Mail-Einwilligung oder DSGVO-Rechtsgrundlage erfasst, müssen diese Felder in Ihrem Export enthalten sein. Sie sind nicht in den Standard-Exportspalten enthalten. Fügen Sie sie explizit hinzu. Der Verlust von Einwilligungsdatensätzen kann im Zielsystem Compliance-Probleme verursachen. Der Wikipedia-Überblick zur DSGVO beschreibt die Kategorien der Rechtsgrundlage und die Verpflichtungen zum Recht auf Löschung, die für CRM-Kontaktdaten gelten.

Gelöschte Datensätze nicht berücksichtigen. HubSpot hat keinen Papierkorb, der leicht über den Export zugänglich ist. Wenn Sie Datensätze gelöscht haben, die in der Migration enthalten sein müssen, müssen Sie mit dem HubSpot-Support zusammenarbeiten oder den Archivierte-Datensätze-Endpunkt der API nutzen.

---

Wie Sie weitermachen

Ein validierter HubSpot-Export bedeutet, dass Sie Basis-Datensatzdateien sowie Verknüpfungs- und Engagement-Daten haben. Aber nichts davon ist importbereit.

Der nächste Schritt ist Datenbereinigung: Deduplizierung, Normalisierung und Anreicherung. HubSpot-Portale häufen im Laufe der Jahre Duplikate, inkonsistente Eigenschaftswerte und Formatierungsprobleme an. Bereinigen Sie vor dem Import. Laut Statista-CRM-Marktdaten nutzen über 91 % der Unternehmen mit mehr als 11 Mitarbeitern CRM-Software. Die Datenqualitätsprobleme, die sich in langjährig betriebenen CRM-Instanzen ansammeln, sind unabhängig vom Anbieter konsistent.

Wenn Sie Engagement-Historie migrieren, behandelt Umgang mit historischen Aktivitäten, Notizen und E-Mails den Entscheidungsrahmen dafür, was tatsächlich migriert und was archiviert werden soll.

Wenn Sie das Pre-Migrations-Inventar noch nicht abgeschlossen haben, werden diese Entscheidungen in Ihre Daten vorbereiten, bevor Sie irgendetwas migrieren getroffen, bevor der Export beginnt.

---

Mehr erfahren

• Datenbereinigung: Deduplizierung, Normalisierung, Anreicherung
• Umgang mit historischen Aktivitäten, Notizen und E-Mails
• Ihre Daten vorbereiten, bevor Sie irgendetwas migrieren
• Felder zwischen Legacy-System und neuem System abbilden
• CRM-Rollout und Adoption: Ihr Team zur tatsächlichen Nutzung bringen
• RevOps-Reifegradmodell: Wo Ihr Team steht und was als nächstes kommt