Wenn Sie E-Mail-Kampagnen durchführen oder Kontakte zwischen Ihrer App und einem ESP synchronisieren, benötigen Sie eine klare Regel: Wer darf E-Mails erhalten und wer muss ausgeschlossen werden. verify-email.app ersetzt nicht den Abmeldelink Ihres ESPs oder die Einhaltung gesetzlicher Vorschriften, aber es bietet Ihnen Blacklist und Whitelist Regeln, die in jeder Verifizierungsantwort als ein einziges Feld erscheinen: block. Ihr Code kann block lesen, bevor Sie senden, eine Liste importieren oder ein Konto erstellen - ohne die erlauben/verbieten Logik in jeden Dienst zu kopieren.

• Blacklist — Wenn die E-Mail oder ihre Domain auf Ihrer Blacklist steht, gibt die API block: true zurück. Verwenden Sie dies für Personen, die sich abgemeldet haben, Missbrauchsfälle oder Domains, die Sie niemals kontaktieren möchten.

• Whitelist — Wenn der Whitelist-Modus aktiviert ist, erhalten nur Adressen (oder ganze Domains), die Sie zur Whitelist hinzugefügt haben, block: false. Alle anderen erhalten block: true. Verwenden Sie dies für geschlossene Listen - Partner, Einladungen, interne Betas - nicht für einen normalen „jeder kann abonnieren“ Newsletter.

• Reihenfolge — Die Blacklist gewinnt. Wenn eine Adresse auf der Blacklist steht, bleibt sie blockiert, auch wenn sie auch auf der Whitelist steht.

1. Wenn sich ein Benutzer in Ihrer App abmeldet oder Sie einen ESP-Webhook verarbeiten, nehmen Sie dessen Adresse (oder die Domain, die Sie aufgrund von Richtlinien blockieren).

2. Fügen Sie sie mit POST /v1/blacklist und JSON-Body {"value": "[email protected]"} (oder "example.com", um alle Adressen dieser Domain zu blockieren) hinzu. Verwenden Sie den Header X-API-Key mit Ihrem API-Schlüssel.

3. Bevor Sie eine Kampagne senden oder eine Zeile in Ihr Mailing-Tool übertragen, überprüfen Sie die Adresse. Wenn block wahr ist, überspringen Sie diesen Empfänger.

Um sie später wieder zuzulassen (z.B. sie haben sich erneut angemeldet und bestätigt), entfernen Sie die Regel mit DELETE /v1/[email protected].

1. Schalten Sie den strikten Erlauben-nur-Modus ein: PUT /v1/whitelist/enabled mit Body {"enabled": true}.

2. Fügen Sie jede genehmigte Adresse oder Domain hinzu: POST /v1/whitelist mit {"value": "[email protected]"} oder {"value": "company.com"}.

3. Beim Verifizieren bedeutet block: false, dass die Adresse unter Ihrer Whitelist erlaubt ist; alle anderen werden blockiert, bis Sie sie hinzufügen.

Wenn Sie den Erlauben-nur-Modus nicht mehr benötigen (z.B. öffentliche Anmeldung zurückkehrt), setzen Sie enabled zurück auf false, sodass die Whitelist alle anderen nicht mehr einschränkt.

Die meisten Produkte speichern das Einverständnis im ESP und pflegen dort eine Unterdrückungsliste. In verify-email.app entfernen Sie normalerweise die Adresse von der Blacklist, wenn sie zuvor abgemeldet waren (DELETE bei Blacklist), verlassen sich dann auf Ihren ESP für den tatsächlichen Abonnementstatus. Reservieren Sie die Whitelist für Abläufe, bei denen nur vorab genehmigte E-Mails passieren dürfen.

Sie können die gleichen Regeln im Dashboard sowie über die API verwalten – sehen Sie sich die Blacklist und Whitelist Seiten auf verify-email.app für Kontext und API-Details an.