Zum Hauptinhalt springen

HubSpot Kontakt-Unternehmen-Importfehler und Lösungen

Nichts wird hochgeladenGetestet bis 10 MB

Finde Fehler bei HubSpot-Zuordnungsimporten: falsches Objektpaar, fehlende Kennungen, doppelte Unternehmensschlüssel und Primary-Mapping.

Veröffentlicht: 2026-09-24Aktualisiert: 2026-09-242 minZuordnungsimport vorbereiten
Illustration des Datenablaufs für „HubSpot Kontakt-Unternehmen-Importfehler und Lösungen“

Wenn ein HubSpot-Zuordnungsimport nicht weiterkommt, liegt es häufig nicht nur an der CSV. Der Import braucht auch das richtige Objektpaar, eine verwertbare Kennung für jedes Objekt und eine korrekt zugeordnete Beziehungsbezeichnung.

Der Import zeigt den falschen Beziehungstyp

Wenn die Zuordnung als Kontakt–Kontakt statt Kontakt–Unternehmen erscheint, zur Importkonfiguration zurückgehen und prüfen, ob Kontakte und Unternehmen als zwei beteiligte Objekte ausgewählt wurden. Eine Spalte mit Unternehmensname in einer Kontaktdatei erzeugt die Beziehung nicht automatisch.

Für solche Zuordnungen den erweiterten HubSpot-Import verwenden. Der schnelle Kontaktimport bietet diese Zuordnungskonfiguration nicht in gleicher Form an.

Das Unternehmen wird nicht eindeutig gefunden

Als Unternehmenskennung eignen sich unter anderem Company domain name, Record ID oder eine als eindeutig konfigurierte Unternehmenseigenschaft. Prüfe die gewählte Spalte auf doppelte Werte. Zwei Unternehmensdatensätze mit demselben Schlüssel machen die Zuordnung unklar.

Der Kontakt wird nicht eindeutig gefunden

Für Kontakte sind E-Mail und Record ID typische Kennungen; auch eine benutzerdefinierte eindeutige Eigenschaft kann verwendet werden. Leere Kennungen sollten vor dem Import korrigiert werden.

Die Beziehung ist vorhanden, aber nicht Primary

Eine Spalte für die Zuordnungsbezeichnung mappen und für die gewünschte primäre Beziehung Primary verwenden. Das Setzen einer Unternehmensname-Eigenschaft ist nicht dasselbe.

Wenn ein Kontakt schon mehrere Unternehmen hat, nach dem Import stichprobenartig prüfen, ob die richtige Beziehung als Primary markiert ist.

Plausible, aber mehrdeutige Treffer

Besonders riskant sind zwei gleichnamige Unternehmen, mehrere Gesellschaften mit derselben Domain oder mehrfach verwendete Kundennummern. Ein Vorbereitungswerkzeug sollte solche Fälle anzeigen und nicht stillschweigend einen Datensatz auswählen.

Nablyx lässt nicht gefundene und mehrdeutige Paare aus der erzeugten Zuordnungs-CSV heraus, damit sie vor dem Import geprüft werden können.

Sinnvolle Reihenfolge bei der Fehlersuche

  1. Prüfen, ob Kontakte und Unternehmen importiert werden.
  2. Für beide Objekte eine gültige Kennung festlegen.
  3. Doppelte Werte im Unternehmensschlüssel finden.
  4. Kontrollieren, dass die Association-label-Spalte Primary enthält.
  5. Zuerst eine kleine Stichprobe importieren und die Beziehungen in HubSpot prüfen.

Die HubSpot-Dokumentation zu Importfehlern hilft bei Importproblemen; die Dokumentation zu Zuordnungen erklärt das Beziehungsmodell.

Zuordnungs-CSV vorbereiten

Transformation ansehen

Zwei Tabellen treffen sich über einen exakten Suchschlüssel.

Ergänzen Sie passende Kundendaten zu jeder Bestellung und behalten Sie fehlende oder doppelte Treffer im Blick.

orders.csv · customer_id
orderkeyamount
1001C-4284.50
1002C-9142.75
customers.csv · id
keynametier
C-42AminaPro
C-42AminaVIP
Ergebnis
orderkeynametier
1001C-42AminaPro
1002C-91——