# Verification list events

> Verification lists created and completed.



## email_verification_list.created

> Sent when you create an email verification list. The list is already processing and stats has its starting values.

# email_verification_list.created

Sent when you create a list with [Create a list](/docs/api-reference/email-verifications/lists/create/). Verification has already started, so `status` is `processing`, and `stats` has its starting values.

Webhook requests carry a JSON array of events like this one; see [Webhook requests](/docs/webhooks/webhook-requests/).

```json
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email_verification_list.created",
  "object": {
    "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
    "object": "email_verification_list",
    "name": "October newsletter import",
    "status": "processing",
    "stats": {
      "total_emails": 1000,
      "processed_emails": 0,
      "successful_verifications": 0,
      "failed_verifications": 0,
      "pending_emails": 1000,
      "results": {
        "safe": 0,
        "role": 0,
        "catch_all": 0,
        "unknown": 0,
        "inbox_full": 0,
        "disabled": 0,
        "disposable": 0,
        "invalid": 0
      }
    },
    "created_at": "2026-10-01T10:30:02.441000+00:00",
    "updated_at": "2026-10-01T10:30:02.502000+00:00"
  },
  "data": {
    "object": {
      "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
      "object": "email_verification_list",
      "name": "October newsletter import",
      "status": "processing",
      "stats": {
        "total_emails": 1000,
        "processed_emails": 0,
        "successful_verifications": 0,
        "failed_verifications": 0,
        "pending_emails": 1000,
        "results": {
          "safe": 0,
          "role": 0,
          "catch_all": 0,
          "unknown": 0,
          "inbox_full": 0,
          "disabled": 0,
          "disposable": 0,
          "invalid": 0
        }
      },
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:30:02.502000+00:00"
    }
  }
}
```

## Fields

- `event_id` (string): Event ID (`evt_…`). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with [Retrieve an event](/docs/api-reference/events/get/).

- `type` (string): Always `email_verification_list.created`.

- `object` (object): The verification list the event describes. Its fields are listed below.

- `data.object` (object): The same object again, in the shape that the [Events API](/docs/api-reference/events/get/) returns in `data`.

### Verification list object

- `id` (string): List ID (`evl_…`).

- `object` (string): Always `email_verification_list`.

- `name` (string): List name.

- `status` (string): `processing` on `email_verification_list.created`, `completed` on `email_verification_list.updated`.

- `stats` (object): Counts: `total_emails`, `processed_emails`, `successful_verifications`, `failed_verifications` and `pending_emails`, plus `results` with the finished addresses by result. See [Stats](/docs/api-reference/email-verifications/lists/create/#stats).

- `created_at` (string): When the list was created, in ISO 8601 with a UTC offset.

- `updated_at` (string): When the list was last updated.

---
Source: https://emailit.com/docs/webhooks/events/email-verification-list/email-verification-list-created/

## email_verification_list.updated

> Sent when every address in an email verification list has been processed and the list is completed, with final counts.

# email_verification_list.updated

Sent when every address in a verification list has a final result and the list status changes to `completed`. `stats` has the final counts, and `stats.results` the number of addresses with each result. Read the results with [List results](/docs/api-reference/email-verifications/lists/results/) or download them with [Export results](/docs/api-reference/email-verifications/lists/export/).

Webhook requests carry a JSON array of events like this one; see [Webhook requests](/docs/webhooks/webhook-requests/).

```json
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email_verification_list.updated",
  "object": {
    "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
    "object": "email_verification_list",
    "name": "October newsletter import",
    "status": "completed",
    "stats": {
      "total_emails": 1000,
      "processed_emails": 1000,
      "successful_verifications": 996,
      "failed_verifications": 4,
      "pending_emails": 0,
      "results": {
        "safe": 702,
        "role": 41,
        "catch_all": 88,
        "unknown": 37,
        "inbox_full": 3,
        "disabled": 6,
        "disposable": 12,
        "invalid": 107
      }
    },
    "created_at": "2026-10-01T10:30:02.441000+00:00",
    "updated_at": "2026-10-01T10:41:57.020000+00:00"
  },
  "data": {
    "object": {
      "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
      "object": "email_verification_list",
      "name": "October newsletter import",
      "status": "completed",
      "stats": {
        "total_emails": 1000,
        "processed_emails": 1000,
        "successful_verifications": 996,
        "failed_verifications": 4,
        "pending_emails": 0,
        "results": {
          "safe": 702,
          "role": 41,
          "catch_all": 88,
          "unknown": 37,
          "inbox_full": 3,
          "disabled": 6,
          "disposable": 12,
          "invalid": 107
        }
      },
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:41:57.020000+00:00"
    }
  }
}
```

## Fields

- `event_id` (string): Event ID (`evt_…`). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with [Retrieve an event](/docs/api-reference/events/get/).

- `type` (string): Always `email_verification_list.updated`.

- `object` (object): The verification list the event describes. Its fields are listed below.

- `data.object` (object): The same object again, in the shape that the [Events API](/docs/api-reference/events/get/) returns in `data`.

### Verification list object

- `id` (string): List ID (`evl_…`).

- `object` (string): Always `email_verification_list`.

- `name` (string): List name.

- `status` (string): `processing` on `email_verification_list.created`, `completed` on `email_verification_list.updated`.

- `stats` (object): Counts: `total_emails`, `processed_emails`, `successful_verifications`, `failed_verifications` and `pending_emails`, plus `results` with the finished addresses by result. See [Stats](/docs/api-reference/email-verifications/lists/create/#stats).

- `created_at` (string): When the list was created, in ISO 8601 with a UTC offset.

- `updated_at` (string): When the list was last updated.

---
Source: https://emailit.com/docs/webhooks/events/email-verification-list/email-verification-list-updated/
