Docs Webhooks Events

email_verification.created

Fired when a new email verification is created.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email_verification.created",
  "data": {
    "object": {
      "id": "ev_adasaadas525223r",
      "object": "email_verification",
      "email": "exists@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": 5840
      },
      "address": {
        "mailbox": "exists",
        "domain": "example.com",
        "suffix": null,
        "root": "exists@example.com"
      },
      "did_you_mean": null,
      "mx_records": [
        {
          "priority": 10,
          "exchange": "mail.example.com"
        }
      ],
      "created_at": "2025-12-24T09:00:00.000000Z",
      "updated_at": "2025-12-24T10:30:00.000000Z"
    }
  }
}

Fields

id string

Unique verification identifier.

object string

Always email_verification.

email string

Email address that was verified.

status string

Verification status (completed, pending, failed).

score integer

Deliverability score (0-100).

risk string

Risk level (low, medium, high, unknown).

result string

Verification result (safe, risky, invalid, unknown).

mode string

Verification mode (full, fast).

checks object

Individual verification checks including valid_syntax, disposable, role_account, inbox_full, deliverable, disabled, free_email, gibberish, catch_all, smtp_connect, has_mx_records, and domain_age.

address object

Parsed email address components including mailbox, domain, suffix, and root.

did_you_mean string | null

Suggested correction if applicable.

mx_records array

MX records for the domain.

created_at string

ISO 8601 timestamp.

updated_at string

ISO 8601 timestamp.

email_verification.updated

Fired when an email verification is updated.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email_verification.updated",
  "data": {
    "object": {
      "id": "ev_adasaadas525223r",
      "object": "email_verification",
      "email": "exists@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": 5840
      },
      "address": {
        "mailbox": "exists",
        "domain": "example.com",
        "suffix": null,
        "root": "exists@example.com"
      },
      "did_you_mean": null,
      "mx_records": [
        {
          "priority": 10,
          "exchange": "mail.example.com"
        }
      ],
      "created_at": "2025-12-24T09:00:00.000000Z",
      "updated_at": "2025-12-24T10:30:00.000000Z"
    }
  }
}

Fields

id string

Unique verification identifier.

object string

Always email_verification.

email string

Email address that was verified.

status string

Verification status (completed, pending, failed).

score integer

Deliverability score (0-100).

risk string

Risk level (low, medium, high, unknown).

result string

Verification result (safe, risky, invalid, unknown).

mode string

Verification mode (full, fast).

checks object

Individual verification checks including valid_syntax, disposable, role_account, inbox_full, deliverable, disabled, free_email, gibberish, catch_all, smtp_connect, has_mx_records, and domain_age.

address object

Parsed email address components including mailbox, domain, suffix, and root.

did_you_mean string | null

Suggested correction if applicable.

mx_records array

MX records for the domain.

created_at string

ISO 8601 timestamp.

updated_at string

ISO 8601 timestamp.

email_verification.deleted

Fired when an email verification is deleted.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email_verification.deleted",
  "data": {
    "object": {
      "id": "ev_adasaadas525223r",
      "object": "email_verification",
      "email": "exists@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": 5840
      },
      "address": {
        "mailbox": "exists",
        "domain": "example.com",
        "suffix": null,
        "root": "exists@example.com"
      },
      "did_you_mean": null,
      "mx_records": [
        {
          "priority": 10,
          "exchange": "mail.example.com"
        }
      ],
      "created_at": "2025-12-24T09:00:00.000000Z",
      "updated_at": "2025-12-24T10:30:00.000000Z"
    }
  }
}

Fields

id string

Unique verification identifier.

object string

Always email_verification.

email string

Email address that was verified.

status string

Verification status (completed, pending, failed).

score integer

Deliverability score (0-100).

risk string

Risk level (low, medium, high, unknown).

result string

Verification result (safe, risky, invalid, unknown).

mode string

Verification mode (full, fast).

checks object

Individual verification checks including valid_syntax, disposable, role_account, inbox_full, deliverable, disabled, free_email, gibberish, catch_all, smtp_connect, has_mx_records, and domain_age.

address object

Parsed email address components including mailbox, domain, suffix, and root.

did_you_mean string | null

Suggested correction if applicable.

mx_records array

MX records for the domain.

created_at string

ISO 8601 timestamp.

updated_at string

ISO 8601 timestamp.