Événements de vérification
Adresses uniques vérifiées via l’API, et chaque adresse d’une liste de vérification dès que son traitement est terminé.
email_verification.created
Envoyé lorsque vous vérifiez une adresse avec Vérifier une adresse. La vérification est déjà terminée et le payload correspond à la réponse de l’API. Les adresses des listes de vérification déclenchent plutôt email_verification.updated.
Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.
Champs
event_idstringID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.
typestringToujours email_verification.created.
objectobjectLa vérification décrite par l’événement. Ses champs sont détaillés ci-dessous.
data.objectobjectLe même objet, sous la forme que l’API des événements renvoie dans data.
Objet vérification
idstringID de la vérification (ev_…).
objectstringToujours email_verification.
emailstringAdresse vérifiée.
statusstringcompleted lorsque la vérification est terminée, ou failed.
scoreintegerScore de 0 à 100.
riskstringlow, medium ou high.
resultstringsafe, invalid, disposable, disabled, inbox_full, role ou unknown. Consultez Vérifier une adresse.
modestringfast ou full. Les adresses des listes sont toujours vérifiées en mode full.
checksobjectContrôles individuels. Les contrôles de boîte aux lettres smtp_connect, deliverable, disabled, inbox_full et catch_all valent null en mode fast.
addressobjectL’adresse décomposée en mailbox, domain, suffix (la partie après le +) et root.
did_you_meanstring | nullCorrection suggérée en cas de faute de frappe probable.
mx_recordsobject[]Enregistrements MX du domaine, chacun avec priority et exchange.
created_atstringDate de création de la vérification, au format ISO 8601 avec décalage UTC.
updated_atstringDate de dernière mise à jour de la vérification.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification.created",
"object": {
"id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "fast",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": null,
"deliverable": null,
"disabled": null,
"free_email": false,
"gibberish": false,
"catch_all": null,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
},
"data": {
"object": {
"id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "fast",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": null,
"deliverable": null,
"disabled": null,
"free_email": false,
"gibberish": false,
"catch_all": null,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
}
}
}email_verification.updated
Envoyé lorsqu’Emailit termine la vérification d’une adresse d’une liste de vérification, une fois par adresse. Une liste de 10 000 adresses envoie 10 000 de ces événements ; si vous avez seulement besoin de savoir quand la liste entière est terminée, écoutez plutôt email_verification_list.updated.
Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.
Champs
event_idstringID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.
typestringToujours email_verification.updated.
objectobjectLa vérification décrite par l’événement. Ses champs sont détaillés ci-dessous.
data.objectobjectLe même objet, sous la forme que l’API des événements renvoie dans data.
Objet vérification
idstringID de la vérification (ev_…).
objectstringToujours email_verification.
emailstringAdresse vérifiée.
statusstringcompleted lorsque la vérification est terminée, ou failed.
scoreintegerScore de 0 à 100.
riskstringlow, medium ou high.
resultstringsafe, invalid, disposable, disabled, inbox_full, role ou unknown. Consultez Vérifier une adresse.
modestringfast ou full. Les adresses des listes sont toujours vérifiées en mode full.
checksobjectContrôles individuels. Les contrôles de boîte aux lettres smtp_connect, deliverable, disabled, inbox_full et catch_all valent null en mode fast.
addressobjectL’adresse décomposée en mailbox, domain, suffix (la partie après le +) et root.
did_you_meanstring | nullCorrection suggérée en cas de faute de frappe probable.
mx_recordsobject[]Enregistrements MX du domaine, chacun avec priority et exchange.
created_atstringDate de création de la vérification, au format ISO 8601 avec décalage UTC.
updated_atstringDate de dernière mise à jour de la vérification.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification.updated",
"object": {
"id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "full",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": false,
"deliverable": true,
"disabled": false,
"free_email": false,
"gibberish": false,
"catch_all": false,
"smtp_connect": true,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:09.876000+00:00"
},
"data": {
"object": {
"id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "full",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": false,
"deliverable": true,
"disabled": false,
"free_email": false,
"gibberish": false,
"catch_all": false,
"smtp_connect": true,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:09.876000+00:00"
}
}
}