Saltar al contenido
Docs

Eventos de listas de direcciones

Listas de direcciones creadas y completadas.

email_verification_list.created

Se envía cuando creas una lista con Crear una lista. La verificación ya ha empezado, así que status es processing y stats tiene sus valores iniciales.

Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.

Campos

event_idstring

El ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.

typestring

Siempre email_verification_list.created.

objectobject

La lista de direcciones que describe el evento. Sus campos se indican a continuación.

data.objectobject

El mismo objeto otra vez, con la forma que devuelve la API de eventos en data.

Objeto de lista de direcciones

idstring

El ID de la lista (evl_…).

objectstring

Siempre email_verification_list.

namestring

El nombre de la lista.

statusstring

processing en email_verification_list.created, completed en email_verification_list.updated.

statsobject

Los recuentos: total_emails, processed_emails, successful_verifications, failed_verifications y pending_emails, además de results con las direcciones terminadas por resultado. Consulta Estadísticas.

created_atstring

Cuándo se creó la lista, en formato ISO 8601 con desfase respecto a UTC.

updated_atstring

Cuándo se actualizó la lista por última vez.

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"
    }
  }
}

email_verification_list.updated

Se envía cuando todas las direcciones de una lista tienen un resultado final y su estado cambia a completed. stats contiene los recuentos finales, y stats.results, el número de direcciones con cada resultado. Lee los resultados con Listar resultados o descárgalos con Exportar resultados.

Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.

Campos

event_idstring

El ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.

typestring

Siempre email_verification_list.updated.

objectobject

La lista de direcciones que describe el evento. Sus campos se indican a continuación.

data.objectobject

El mismo objeto otra vez, con la forma que devuelve la API de eventos en data.

Objeto de lista de direcciones

idstring

El ID de la lista (evl_…).

objectstring

Siempre email_verification_list.

namestring

El nombre de la lista.

statusstring

processing en email_verification_list.created, completed en email_verification_list.updated.

statsobject

Los recuentos: total_emails, processed_emails, successful_verifications, failed_verifications y pending_emails, además de results con las direcciones terminadas por resultado. Consulta Estadísticas.

created_atstring

Cuándo se creó la lista, en formato ISO 8601 con desfase respecto a UTC.

updated_atstring

Cuándo se actualizó la lista por última vez.

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"
    }
  }
}

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.