Zum Inhalt springen
Doku

Verifizierungs-Events

Einzelne per API verifizierte Adressen und jede Adresse einer Verifizierungsliste, sobald sie fertig ist.

email_verification.created

Wird gesendet, wenn Sie eine Adresse mit Adresse verifizieren verifizieren. Die Verifizierung ist bereits abgeschlossen, und der Payload entspricht der API-Antwort. Adressen in Verifizierungslisten lösen stattdessen email_verification.updated aus.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

Event-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.

typestring

Immer email_verification.created.

objectobject

Die Verifizierung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Verifizierungs-Objekt

idstring

Verifizierungs-ID (ev_…).

objectstring

Immer email_verification.

emailstring

Verifizierte Adresse.

statusstring

completed, wenn die Prüfung abgeschlossen wurde, oder failed.

scoreinteger

Score von 0 bis 100.

riskstring

low, medium oder high.

resultstring

safe, invalid, disposable, disabled, inbox_full, role oder unknown. Siehe Adresse verifizieren.

modestring

fast oder full. Adressen in Listen werden immer im Modus full geprüft.

checksobject

Einzelne Prüfungen. Die Postfachprüfungen smtp_connect, deliverable, disabled, inbox_full und catch_all sind im Modus fast gleich null.

addressobject

Die Adresse, aufgeteilt in mailbox, domain, suffix (der Teil nach +) und root.

did_you_meanstring | null

Korrekturvorschlag bei einem wahrscheinlichen Tippfehler.

mx_recordsobject[]

MX-Einträge der Domain, jeweils mit priority und exchange.

created_atstring

Zeitpunkt der Erstellung der Verifizierung, im Format ISO 8601 mit UTC-Offset.

updated_atstring

Zeitpunkt der letzten Aktualisierung der Verifizierung.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email_verification.created",
  "object": {
    "id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
    "object": "email_verification",
    "email": "ada@example.com",
    "status": "completed",
    "score": 100,
    "risk": "low",
    "result": "safe",
    "mode": "fast",
    "checks": {
      "valid_syntax": true,
      "disposable": false,
      "role_account": false,
      "inbox_full": null,
      "deliverable": null,
      "disabled": null,
      "free_email": false,
      "gibberish": false,
      "catch_all": null,
      "smtp_connect": null,
      "has_mx_records": true,
      "domain_age": 10957
    },
    "address": {
      "mailbox": "ada",
      "domain": "example.com",
      "suffix": null,
      "root": "ada@example.com"
    },
    "did_you_mean": null,
    "mx_records": [
      {
        "priority": 10,
        "exchange": "mx1.example.com"
      }
    ],
    "created_at": "2026-10-01T10:20:31.118000+00:00",
    "updated_at": "2026-10-01T10:20:31.118000+00:00"
  },
  "data": {
    "object": {
      "id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
      "object": "email_verification",
      "email": "ada@example.com",
      "status": "completed",
      "score": 100,
      "risk": "low",
      "result": "safe",
      "mode": "fast",
      "checks": {
        "valid_syntax": true,
        "disposable": false,
        "role_account": false,
        "inbox_full": null,
        "deliverable": null,
        "disabled": null,
        "free_email": false,
        "gibberish": false,
        "catch_all": null,
        "smtp_connect": null,
        "has_mx_records": true,
        "domain_age": 10957
      },
      "address": {
        "mailbox": "ada",
        "domain": "example.com",
        "suffix": null,
        "root": "ada@example.com"
      },
      "did_you_mean": null,
      "mx_records": [
        {
          "priority": 10,
          "exchange": "mx1.example.com"
        }
      ],
      "created_at": "2026-10-01T10:20:31.118000+00:00",
      "updated_at": "2026-10-01T10:20:31.118000+00:00"
    }
  }
}

email_verification.updated

Wird gesendet, wenn Emailit die Verifizierung einer Adresse in einer Verifizierungsliste abschließt, einmal pro Adresse. Eine Liste mit 10.000 Adressen löst 10.000 dieser Events aus; wenn Sie nur wissen müssen, wann die ganze Liste fertig ist, abonnieren Sie stattdessen email_verification_list.updated.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.

Felder

event_idstring

Event-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.

typestring

Immer email_verification.updated.

objectobject

Die Verifizierung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Verifizierungs-Objekt

idstring

Verifizierungs-ID (ev_…).

objectstring

Immer email_verification.

emailstring

Verifizierte Adresse.

statusstring

completed, wenn die Prüfung abgeschlossen wurde, oder failed.

scoreinteger

Score von 0 bis 100.

riskstring

low, medium oder high.

resultstring

safe, invalid, disposable, disabled, inbox_full, role oder unknown. Siehe Adresse verifizieren.

modestring

fast oder full. Adressen in Listen werden immer im Modus full geprüft.

checksobject

Einzelne Prüfungen. Die Postfachprüfungen smtp_connect, deliverable, disabled, inbox_full und catch_all sind im Modus fast gleich null.

addressobject

Die Adresse, aufgeteilt in mailbox, domain, suffix (der Teil nach +) und root.

did_you_meanstring | null

Korrekturvorschlag bei einem wahrscheinlichen Tippfehler.

mx_recordsobject[]

MX-Einträge der Domain, jeweils mit priority und exchange.

created_atstring

Zeitpunkt der Erstellung der Verifizierung, im Format ISO 8601 mit UTC-Offset.

updated_atstring

Zeitpunkt der letzten Aktualisierung der Verifizierung.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email_verification.updated",
  "object": {
    "id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
    "object": "email_verification",
    "email": "ada@example.com",
    "status": "completed",
    "score": 100,
    "risk": "low",
    "result": "safe",
    "mode": "full",
    "checks": {
      "valid_syntax": true,
      "disposable": false,
      "role_account": false,
      "inbox_full": false,
      "deliverable": true,
      "disabled": false,
      "free_email": false,
      "gibberish": false,
      "catch_all": false,
      "smtp_connect": true,
      "has_mx_records": true,
      "domain_age": 10957
    },
    "address": {
      "mailbox": "ada",
      "domain": "example.com",
      "suffix": null,
      "root": "ada@example.com"
    },
    "did_you_mean": null,
    "mx_records": [
      {
        "priority": 10,
        "exchange": "mx1.example.com"
      }
    ],
    "created_at": "2026-10-01T10:30:02.441000+00:00",
    "updated_at": "2026-10-01T10:30:09.876000+00:00"
  },
  "data": {
    "object": {
      "id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
      "object": "email_verification",
      "email": "ada@example.com",
      "status": "completed",
      "score": 100,
      "risk": "low",
      "result": "safe",
      "mode": "full",
      "checks": {
        "valid_syntax": true,
        "disposable": false,
        "role_account": false,
        "inbox_full": false,
        "deliverable": true,
        "disabled": false,
        "free_email": false,
        "gibberish": false,
        "catch_all": false,
        "smtp_connect": true,
        "has_mx_records": true,
        "domain_age": 10957
      },
      "address": {
        "mailbox": "ada",
        "domain": "example.com",
        "suffix": null,
        "root": "ada@example.com"
      },
      "did_you_mean": null,
      "mx_records": [
        {
          "priority": 10,
          "exchange": "mx1.example.com"
        }
      ],
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:30:09.876000+00:00"
    }
  }
}

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.