Eventos de lista de verificação
Listas de verificação criadas e concluídas.
email_verification_list.created
Enviado quando você cria uma lista com Criar uma lista. A verificação já começou, então status é processing, e stats tem os valores iniciais.
As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.
Campos
event_idstringID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.
typestringSempre email_verification_list.created.
objectobjectA lista de verificação que o evento descreve. Os campos dela estão listados abaixo.
data.objectobjectO mesmo objeto de novo, no formato que a API de eventos retorna em data.
Objeto de lista de verificação
idstringID da lista (evl_…).
objectstringSempre email_verification_list.
namestringNome da lista.
statusstringprocessing em email_verification_list.created, completed em email_verification_list.updated.
statsobjectContagens: total_emails, processed_emails, successful_verifications, failed_verifications e pending_emails, além de results com os endereços concluídos por resultado. Consulte Estatísticas.
created_atstringQuando a lista foi criada, em ISO 8601 com deslocamento UTC.
updated_atstringQuando a lista foi atualizada pela ú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
Enviado quando todos os endereços de uma lista de verificação têm um resultado final e o status da lista muda para completed. stats tem as contagens finais, e stats.results, o número de endereços com cada resultado. Leia os resultados com Listar resultados ou baixe-os com Exportar resultados.
As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.
Campos
event_idstringID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.
typestringSempre email_verification_list.updated.
objectobjectA lista de verificação que o evento descreve. Os campos dela estão listados abaixo.
data.objectobjectO mesmo objeto de novo, no formato que a API de eventos retorna em data.
Objeto de lista de verificação
idstringID da lista (evl_…).
objectstringSempre email_verification_list.
namestringNome da lista.
statusstringprocessing em email_verification_list.created, completed em email_verification_list.updated.
statsobjectContagens: total_emails, processed_emails, successful_verifications, failed_verifications e pending_emails, além de results com os endereços concluídos por resultado. Consulte Estatísticas.
created_atstringQuando a lista foi criada, em ISO 8601 com deslocamento UTC.
updated_atstringQuando a lista foi atualizada pela ú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"
}
}
}