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_idstringEl 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.
typestringSiempre email_verification_list.created.
objectobjectLa lista de direcciones que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de lista de direcciones
idstringEl ID de la lista (evl_…).
objectstringSiempre email_verification_list.
namestringEl nombre de la lista.
statusstringprocessing en email_verification_list.created, completed en email_verification_list.updated.
statsobjectLos 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_atstringCuándo se creó la lista, en formato ISO 8601 con desfase respecto a UTC.
updated_atstringCuándo se actualizó la lista por última vez.
{
"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_idstringEl 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.
typestringSiempre email_verification_list.updated.
objectobjectLa lista de direcciones que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de lista de direcciones
idstringEl ID de la lista (evl_…).
objectstringSiempre email_verification_list.
namestringEl nombre de la lista.
statusstringprocessing en email_verification_list.created, completed en email_verification_list.updated.
statsobjectLos 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_atstringCuándo se creó la lista, en formato ISO 8601 con desfase respecto a UTC.
updated_atstringCuándo se actualizó la lista por última vez.
{
"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"
}
}
}