E-Mails aus HubSpot-Formularen in Echtzeit verifizieren

Ein HubSpot-Formular ist eine Maschine zur Kontakterfassung: Jede Einsendung erstellt oder aktualisiert einen Kontaktdatensatz, setzt Eigenschaften und kann diesen Kontakt in einen Workflow aufnehmen. Was es nicht tut, ist Ihnen zu sagen, ob die Adresse, die jemand eingetippt hat, tatsächlich echt ist. Das E-Mail-Feld von HubSpot führt eine Formatprüfung durch — es bestätigt, dass ein @ und eine Domain vorhanden sind — aber es kann nicht erkennen, dass das Postfach tot ist, zu einem Wegwerfdienst gehört oder ein Tippfehler von gmail.com ist. Dieser Leitfaden zeigt zwei praktische Wege, E-Mails aus HubSpot-Formularen mit Qualisend zu verifizieren: in Echtzeit mit einem Operations-Hub-Workflow, der jede neue Adresse per POST an die Qualisend API sendet, und im großen Stil, indem Sie Kontakte in eine CSV-Datei exportieren. Keiner der beiden Wege benötigt einen nativen Connector — es gibt noch keinen — nur die integrierten Workflow-Aktionen von HubSpot oder dessen Export-Schaltfläche.

Die kurze Antwort#

Wählen Sie den Weg, der dazu passt, wann Sie die Antwort brauchen:

• Echtzeit — nehmen Sie neue Formulareinsender in einen Workflow auf. Eine Custom-Code- oder Webhook-Aktion ruft die Qualisend API mit der E-Mail auf, und eine Verzweigung schreibt das Verdikt in eine Kontakteigenschaft und leitet den Datensatz dann auf Basis des zurückgegebenen status weiter oder unterdrückt ihn.
• Massenweise — exportieren Sie Ihre Kontakte in eine CSV-Datei, lassen Sie sie durch die Massenverifizierung von Qualisend laufen und unterdrücken Sie die nicht zustellbaren Adressen vor Ihrem nächsten Versand.

Warum das Formularfeld von HubSpot kein Postfach bestätigen kann#

Das email-Feld von HubSpot validiert das Format — es prüft, ob die Zeichenkette wie eine Adresse aussieht, bevor es das Formular absenden lässt. Das ist dieselbe Art von Prüfung, die eine Regex durchführt, und sie scheitert aus denselben Gründen: Format ist nicht Zustellbarkeit. jane@gmial.com besteht die Formatprüfung. throwaway@mailinator.com ebenfalls, und ebenso eine echt aussehende Adresse bei einer Domain, die letztes Jahr abgeschaltet wurde.

Keine davon wird abgefangen, bis Sie senden — und bis dahin ist eine tote Adresse ein Hard Bounce, der an Ihrer Bounce-Rate und Ihrer Absenderreputation nagt. Echte Verifizierung fügt die Schichten hinzu, die HubSpot nicht kann: ein DNS/MX-Lookup und eine SMTP-Postfachprüfung, dazu Kennzeichnungen für Wegwerf-, Rollen- und Catch-all-Adressen. Wenn Ihnen dieser Ablauf neu ist, ist was E-Mail-Verifizierung tatsächlich prüft die Einführung.

Zwei Wege, E-Mails aus HubSpot-Formularen zu verifizieren#

Zuerst die wichtige Einschränkung: Ein Standard-HubSpot-Formular kann eine schlechte E-Mail nicht mitten im Absenden blockieren. Es gibt keine unterstützte Möglichkeit, zwischen dem Klick auf „Absenden" und der Erstellung des Datensatzes eine externe API aufzurufen, daher findet die Echtzeit-Verifizierung unmittelbar nach dem Absenden innerhalb eines Workflows statt — nicht als vorgeschaltetes Tor. Das prägt beide Wege unten.

Weg 1: Echtzeit mit einem Operations-Hub-Workflow#

Erstellen Sie einen kontaktbasierten Workflow und setzen Sie den Aufnahme-Trigger auf „Formulareinsendung", beschränkt auf das Formular, das Ihnen wichtig ist. Jeder neue Einsender fließt nun in den Workflow, wo Sie den Verifizierungsaufruf durchführen und auf das Ergebnis reagieren.

Es gibt zwei Wege, diesen Aufruf durchzuführen — wählen Sie den, der zu Ihrem Portal und Ihrem Stack passt.

Option A — eine Custom-Code-Aktion (in sich geschlossen). Wenn Sie Operations Hub Professional oder Enterprise nutzen, führt eine Custom-Code-Aktion Node.js (oder Python) direkt innerhalb des Workflows aus. Fügen Sie die email des aufgenommenen Kontakts als Eingabeeigenschaft hinzu, speichern Sie Ihren Schlüssel als Secret namens QUALISEND_API_KEY und rufen Sie Qualisend aus der Aktion auf:

// HubSpot custom-code action (Node.js) — input property: email, secret: QUALISEND_API_KEY
const QUALISEND_ENDPOINT = "https://api.qualisend.com/v1/verify"; // confirm the path in /developers

exports.main = async (event, callback) => {
  const email = event.inputFields.email;

  const res = await fetch(QUALISEND_ENDPOINT, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QUALISEND_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ email }),
  });

  // Fail open — never block a real lead on a transient API error.
  if (!res.ok) return callback({ outputFields: { email_status: "unknown" } });

  const { result } = await res.json();
  callback({
    outputFields: {
      email_status: result.status, // deliverable / risky / undeliverable / unknown
      email_score: result.score,
    },
  });
};

Die Aktion stellt email_status und email_score als Ausgaben bereit. Lassen Sie darauf einen Schritt Eigenschaftswert kopieren folgen, der email_status in eine benutzerdefinierte Kontakteigenschaft schreibt, und nutzen Sie dann eine Wenn/Dann-Verzweigung, um darauf weiterzuleiten — der ganze Grund, warum Sie die Prüfung durchgeführt haben.

Option B — eine Webhook-Aktion an Ihre eigene Funktion. Möchten Sie die Logik lieber in Ihrer eigenen Codebasis behalten, oder sind Sie nicht auf einer Custom-Code-Stufe? Fügen Sie eine Webhook-Aktion hinzu, die per POST an eine kleine serverlose Funktion sendet, die Sie kontrollieren. Die Funktion holt die E-Mail, ruft Qualisend auf und schreibt das Verdikt über die CRM-API von HubSpot zurück in den Kontakt. Es ist dieselbe serverseitige Form wie beim Verifizieren-bei-Anmeldung-Muster: Der API-Schlüssel verlässt niemals den Server, und Sie reagieren auf das Ergebnis. Der Endpunkt-Code in der Node.js-Anleitung oder der Python-Anleitung lässt sich fast direkt übernehmen — nur das Parsen der Nutzlast ist HubSpot-spezifisch.

So oder so ist die zugrunde liegende Anfrage dieselbe, und die Platzhalter füllen Sie aus der Entwicklerdokumentation:

POST https://api.qualisend.com/v1/verify
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{ "email": "jane@example.com" }

Eine zustellbare Adresse kommt so zurück — ein status, ein score von 0–100, ein reason und eine Reihe von sub_flags:

{
  "result": {
    "status": "deliverable",
    "score": 95,
    "reason": null,
    "sub_flags": { "disposable": false, "role": false, "free": false, "catch_all": false }
  }
}

Zwei Regeln halten das robust. Verwenden Sie einen eingeschränkten Schlüssel, der für diesen Workflow erzeugt wurde, statt eines Schlüssels mit Vollzugriff, damit er, falls er jemals aus einem Log ausläuft, nur verifizieren kann — sonst nichts. Und fail open: Wenn Qualisend eine Zeitüberschreitung hat oder das Plan-Limit erreicht ist, behandeln Sie die Adresse als unknown und behalten Sie den Kontakt, statt einen echten Lead wegen einer vorübergehenden Störung fallen zu lassen — genau das tut die !res.ok-Verzweigung oben.

Nachgelagert ist das Verdikt nur eine Verzweigung. Setzen Sie eine benutzerdefinierte Eigenschaft „E-Mail-Status" aus der Ausgabe und lassen Sie dann Ihren Workflow entscheiden: Ein deliverable-Kontakt läuft weiter in die Nurture-Sequenz; bei einem undeliverable- oder disposable-Kontakt wird das Follow-up zurückgehalten, er wird zur Prüfung markiert oder auf Nicht-Marketing gesetzt, sodass er von aktiven Listen und Versänden ausgeschlossen ist. Der Workflow ist die Verrohrung; die Weiterleitung liegt bei Ihnen.

Weg 2: eine CSV-Ausgabe massenweise verifizieren#

Wenn Sie bereits Tausende von Kontakten haben oder lieber nach einem Zeitplan bereinigen, als Prüfungen pro Einsendung durchzuführen, gehen Sie in Stapeln vor — und dieser Weg benötigt keinen Workflow, sodass er auch unterhalb der Operations-Hub-Stufen funktioniert. Öffnen Sie in HubSpot Kontakte, wählen Sie eine Liste oder einen Filter und exportieren Sie in eine CSV-Datei. Sie erhalten eine Zeile pro Kontakt mit der E-Mail in einer eigenen Spalte.

Dann:

1. Laden Sie die CSV-Datei hoch zur Massenverifizierung von Qualisend und lassen Sie sie den vollständigen Ablauf — MX, SMTP und die Wegwerf-/Rollen-/Catch-all-Kennzeichnungen — über jede Zeile laufen.
2. Laden Sie die annotierte Datei herunter. Jede Adresse kommt mit einem status, einem reason und einem score von 0–100 zurück.
3. Unterdrücken Sie die nicht zustellbaren Adressen wieder in HubSpot: Importieren Sie die Ergebnisse, um Ihre Eigenschaft „E-Mail-Status" zu setzen, und schließen Sie dann alles, was nicht zustellbar ist, von Ihren aktiven Listen und Marketing-Versänden aus.

Das Massenverfahren ist das richtige Werkzeug für einen Rückstand, aber es ist Bereinigung, keine Vorbeugung: Eine Adresse, die Sie hier abfangen, sitzt in der Regel bereits in Ihrer Datenbank. Kombinieren Sie einen regelmäßigen Massendurchlauf mit dem Echtzeit-Workflow, sodass neue schlechte Adressen in dem Moment gekennzeichnet werden, in dem sie eintreffen.

Auf das Verdikt reagieren#

Welcher Weg das Ergebnis auch zurückgibt, die Form ist dieselbe — ein status, ein reason, ein score und die Sub-Flags. Ordnen Sie jedem eine Aktion zu:

Wenn Sie den Workflow-Ansatz von HubSpot gegen den direkten Aufruf der API aus Ihrem eigenen Backend abwägen, gilt derselbe Kompromiss wie bei jeder Verbindungslösung: Workflows punkten bei der Geschwindigkeit der Einrichtung, eine direkte Integration punktet bei Kosten und Kontrolle im großen Maßstab. Dasselbe Webhook-Muster treibt auch die Schwester-Leitfäden für Zapier und Typeform an, falls ein Teil Ihres Eingangs außerhalb von HubSpot liegt.

Häufig gestellte Fragen#

Gibt es eine native Qualisend-Integration für HubSpot?#

Derzeit nicht. Die nativen Plattform-Integrationen von Qualisend werden gerade neu aufgebaut, daher gibt es noch keine gebrandete App zum Installieren im HubSpot Marketplace — sie steht auf der Roadmap. Bis sie erscheint, ist der unterstützte Weg, E-Mails aus HubSpot-Formularen zu verifizieren, eine Workflow-Aktion mit Custom-Code oder Webhook, die auf die Qualisend API zeigt, genau so, wie dieser Leitfaden es beschreibt. Dieser Ansatz ist zudem flexibler: Sie steuern die Anfrage, die Verzweigung und in welche Kontakteigenschaft das Verdikt geschrieben wird.

Benötige ich Operations Hub, um E-Mails aus HubSpot-Formularen zu verifizieren?#

Für den Echtzeit-Workflow praktisch ja. Workflows erfordern eine Professional-Stufe, und die Webhook- und Custom-Code-Aktionen erfordern speziell Operations Hub Professional oder Enterprise. Wenn Ihr Portal auf einer niedrigeren Stufe liegt, nutzen Sie stattdessen den CSV-Export und die Massenverifizierung — dafür brauchen Sie keinen Workflow und keinen Custom-Code, nur einen Export und einen Datei-Upload, sodass es mit jedem Plan funktioniert, mit dem Sie Kontakte exportieren können.

Kann ich eine schlechte E-Mail blockieren, bevor das Formular abgeschickt wird?#

Nicht zuverlässig. Ein Standard-HubSpot-Formular bietet keine unterstützte Möglichkeit, mitten im Absenden eine externe API aufzurufen und die Erstellung des Datensatzes zu verhindern, daher läuft die Echtzeit-Verifizierung unmittelbar nach dem Absenden innerhalb des Workflows. In der Praxis ist das kein Problem: Sie verifizieren innerhalb von Sekunden und handeln, bevor die Adresse jemals eine Nachricht erhält — Sie halten die Willkommens-E-Mail zurück, versehen den Kontakt mit einem Tag oder leiten ihn zur Prüfung weiter, statt das Formular selbst zu blockieren.

Wie unterscheidet sich das vom Bereinigen meiner bestehenden HubSpot-Liste?#

Das Verifizieren beim Eingang verhindert, dass neue schlechte Adressen hineingelangen; das Bereinigen Ihrer bestehenden Liste entfernt die bereits enthaltenen. In diesem Leitfaden geht es um das Erste — jede Einsendung abzufangen, sobald sie eintrifft. Beim Zweiten führen Sie einen einmaligen (oder geplanten) Durchlauf über Ihre gesamte Datenbank durch und entscheiden, was Sie unterdrücken und wie Sie inaktive Kontakte reaktivieren. Die vollständige Routine, einschließlich dessen, wohin jeder Status gehört, finden Sie in wie man eine E-Mail-Liste bereinigt. Die meisten Teams tun beides.

Bereit, es einzurichten? Holen Sie sich einen eingeschränkten Schlüssel und das exakte Anfrageformat in der Entwicklerdokumentation, prüfen Sie eine einzelne Adresse zur Sicherheit im kostenlosen E-Mail-Checker oder starten Sie mit den 100 kostenlosen Credits in jedem Plan, um den Workflow von Anfang bis Ende zu testen, bevor Sie ihn aktivieren.