Zum Inhalt springen
Doku

Fehlerbehebung

Warum ist mein Kontaktimport fehlgeschlagen?

Beheben Sie Kontaktimporte, die fehlschlagen oder weniger Kontakte als erwartet übernehmen. Behandelt das Limit von 2.500 Zeilen, ungültige E-Mail-Adressen, eigene Felder und Obergrenzen für Kontaktlisten.

Aktualisiert am 1. Okt. 2026

Dieser Artikel hilft, wenn der Import von Kontakten aus einer CSV- oder Excel-Datei einen Fehler anzeigt oder mit weniger Kontakten abschließt, als Ihre Datei enthält.

Symptome

Der Dialog Import CSV unter Email MarketingContacts zeigt im Vorschauschritt ein rotes Banner, etwa:

  • A maximum of 2500 contacts can be imported per request.
  • Contact #42 has an invalid email address.
  • Unknown custom field key(s): …
  • Pay as you go includes 10,000 subscribers per audience.

Oder Continue bleibt deaktiviert, mit dem Hinweis You must map at least one column to the Email field.

Ursache

Jeder Import wird als Ganzes geprüft. Schlägt eine Regel fehl, wird nichts importiert:

  • Mehr als 2.500 Zeilen. Jeder Import nimmt bis zu 2.500 Kontakte an.
  • Eine ungültige E-Mail-Adresse. Eine einzige fehlerhafte Adresse lässt die ganze Datei fehlschlagen. Die Nummer in der Meldung zählt Kontakte nach dem Entfernen leerer Zeilen und kann daher von der Zeilennummer in der Tabelle abweichen.
  • Ein eigenes Feld, das nicht existiert. Für Spalten, die eigenen Feldern zugeordnet sind, müssen diese Felder zuerst angelegt werden.
  • Keine Spalte Email zugeordnet. Email ist das einzige Pflichtfeld.
  • Die Kontaktliste würde das Limit Ihres Tarifs überschreiten. Pay as you go erlaubt 10.000 Abonnenten pro Kontaktliste, Pro 50.000 und Business 250.000. Die Prüfung zählt jede Zeile Ihrer Datei plus die aktuellen Abonnenten der Kontaktliste.

Weniger Kontakte als erwartet bedeuten meist Zeilen mit leerer E-Mail-Zelle. Sie werden ohne Fehler übersprungen. Von einer Excel-Datei wird nur das erste Tabellenblatt gelesen.

Lösung

  1. Große Dateien aufteilen. Teilen Sie die Datei in Teile mit höchstens 2.500 Zeilen und importieren Sie sie nacheinander.

  2. E-Mail-Spalte bereinigen. Entfernen Sie Leerzeichen, Satzzeichen am Ende und mehrere Adressen in einer Zelle. Um fehlerhafte oder riskante Adressen zu finden, prüfen Sie die Liste zuerst mit der E-Mail-Verifizierung.

  3. Eigene Felder zuerst anlegen. Fügen Sie fehlende Felder unter WorkspaceSettings im Bereich Custom fields hinzu und starten Sie den Import dann erneut. Siehe Eigene Felder.

  4. Spaltenzuordnung prüfen. Wenn Ihre Datei eine Kopfzeile hat, lassen Sie File has header aktiviert, damit Spalten nach Namen zugeordnet werden. Ordnen Sie eine Spalte Email zu, setzen Sie ungenutzte Spalten auf Exclude und prüfen Sie die Vorschau.

  5. Unter dem Limit der Kontaktliste bleiben. Importieren Sie in eine andere Kontaktliste, entfernen Sie inaktive Abonnenten oder wechseln Sie in einen höheren Tarif. Siehe Limits.

  6. Auf die Verarbeitung warten. Importe laufen im Hintergrund. Wenn der Dialog „Contact import has been queued and will be processed shortly.“ bestätigt, warten Sie eine Minute und aktualisieren Sie die Kontaktliste.

Bereits vorhandene Kontakte werden aktualisiert statt dupliziert. Namen werden nur ersetzt, wenn die Datei einen Wert enthält, und eigene Felder werden zusammengeführt. Die vollständige Anleitung finden Sie unter Kontakte importieren und exportieren. Um Kontakte aus Ihrer App zu synchronisieren, verwenden Sie Kontakt erstellen.

Weiterhin Probleme?

Kontaktieren Sie den Support oder fragen Sie auf Discord und senden Sie die Fehlermeldung und die ersten Zeilen Ihrer Datei ohne personenbezogene Daten mit.

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.