Verification list events
Verification lists created and completed.
email_verification_list.created
Sent when you create a list with Create a list. 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.
Fields
event_idstringEvent 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.
typestringAlways email_verification_list.created.
objectobjectThe verification list the event describes. Its fields are listed below.
data.objectobjectThe same object again, in the shape that the Events API returns in data.
Verification list object
idstringList ID (evl_…).
objectstringAlways email_verification_list.
namestringList name.
statusstringprocessing on email_verification_list.created, completed on email_verification_list.updated.
statsobjectCounts: total_emails, processed_emails, successful_verifications, failed_verifications and pending_emails.
created_atstringWhen the list was created, in ISO 8601 with a UTC offset.
updated_atstringWhen the list was last updated.
{
"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
},
"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
},
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:02.502000+00:00"
}
}
}email_verification_list.updated
Sent when every address in a verification list has been processed and the list status changes to completed. stats has the final counts. Read the results with List results or download them with Export results.
Webhook requests carry a JSON array of events like this one; see Webhook requests.
Fields
event_idstringEvent 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.
typestringAlways email_verification_list.updated.
objectobjectThe verification list the event describes. Its fields are listed below.
data.objectobjectThe same object again, in the shape that the Events API returns in data.
Verification list object
idstringList ID (evl_…).
objectstringAlways email_verification_list.
namestringList name.
statusstringprocessing on email_verification_list.created, completed on email_verification_list.updated.
statsobjectCounts: total_emails, processed_emails, successful_verifications, failed_verifications and pending_emails.
created_atstringWhen the list was created, in ISO 8601 with a UTC offset.
updated_atstringWhen the list was last updated.
{
"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
},
"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
},
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:41:57.020000+00:00"
}
}
}