Référence

Types d’événements

Tous les types d’événements webhook envoyés par Emailit, quand chacun se déclenche, quel objet il contient et quels types le sélecteur du tableau de bord omet.

Mis à jour le 1 oct. 2026

Voici la liste complète des types d’événements qu’Emailit envoie aux webhooks et enregistre dans le flux d’événements. Le data.object de chaque événement contient la ressource concernée ; la colonne Objet indique sa valeur object. Sélectionnez le nom d’un événement pour afficher son payload complet, lorsqu’une page de référence existe.

Un webhook dont l’option All events est activée reçoit tous les types ci-dessous. Lorsque vous choisissez les événements dans le tableau de bord, certains types ne figurent pas dans le sélecteur ; ils sont signalés par « Absent du sélecteur » et vous pouvez les ajouter avec Mettre à jour un webhook.

Événements d’e-mail

Événement	Objet	Déclenché lorsque
`email.accepted`	`email`	Un e-mail envoyé via l’API ou Compose a été accepté et mis en file d’attente. Pas envoyé pour le SMTP.
`email.scheduled`	`email`	Un e-mail envoyé via l’API avec un `scheduled_at` dans le futur a été enregistré. Contient `scheduled_at`.
`email.delivered`	`email`	Le serveur de messagerie du destinataire a accepté le message.
`email.attempted`	`email`	Une tentative de livraison a échoué temporairement et sera renouvelée. Envoyé à chaque tentative ; contient `smtp_code`, `smtp_enhanced_code` et `smtp_response`.
`email.bounced`	`email`	La livraison a échoué définitivement, un rapport de rebond est arrivé après la livraison, ou les nouvelles tentatives sont épuisées.
`email.failed`	`email`	Le traitement a échoué à cause d’une erreur, et non d’une réponse du serveur du destinataire. Rare.
`email.rejected`	`email`	Emailit a refusé d’envoyer à un destinataire parce que l’espace de travail n’est pas vérifié.
`email.suppressed`	`email`	Le destinataire figure dans la liste d’adresses bloquées : l’e-mail n’a pas été envoyé.
`email.held`	`email`	L’e-mail a été retenu et n’a pas été envoyé : espace de travail suspendu, domaine en pause, crédits insuffisants, score de spam de 7 ou plus, ou clé API configurée pour retenir les e-mails. Absent du sélecteur.
`email.canceled`	`email`	L’e-mail a été annulé dans le tableau de bord ou via l’API. Contient `status` et `previous_status`. Absent du sélecteur.
`email.received`	`email`	Un message est arrivé sur votre sous-domaine de réception. Ne contient que `id`, `from`, `to`, `subject` et `created_at`.
`email.complained`	`email`	Le destinataire a signalé l’e-mail comme spam via la boucle de rétroaction (feedback loop) de son fournisseur.
`email.loaded`	`load`	L’image de suivi a été chargée. Envoyé à chaque chargement, pas seulement au premier.
`email.clicked`	`click`	Un lien suivi a été cliqué. Envoyé à chaque clic ; contient `link.url`.
`email.unsubscribed`	`email`	Un destinataire s’est désinscrit via le lien ou la page de désinscription d’un e-mail de campagne. Contient `campaign`, `contact` et `unsubscribed_at`. Absent du sélecteur.
`email.resubscribed`	`email`	Un destinataire s’est réinscrit depuis la page de désinscription. Contient `campaign`, `contact` et `resubscribed_at`. Absent du sélecteur.

Les événements de statut d’e-mail (de email.accepted à email.complained ci-dessus) contiennent les champs id, from, to, subject, status et meta de l’e-mail, ainsi que des horodatages. Les événements de clic et de chargement contiennent leur propre id, l’email_id, un objet email imbriqué (rcpt_to, mail_from, subject, campaign, meta), le contact correspondant s’il existe, ip_address et user_agent. Pour la signification de chaque statut d’e-mail, consultez Statuts des e-mails.

Événements de domaine

Événement	Objet	Déclenché lorsque
`domain.created`	`domain`	Un domaine d’envoi a été ajouté.
`domain.updated`	`domain`	Les paramètres d’un domaine ont changé, par exemple le suivi ou une clé de sous-domaine. Les résultats de la vérification DNS ne déclenchent pas cet événement.
`domain.deleted`	`domain`	Un domaine a été supprimé.

Événements de listes de contacts et d’abonnés

Événement	Objet	Déclenché lorsque
`audience.created`	`audience`	Une liste de contacts a été créée.
`audience.updated`	`audience`	Une liste a été renommée.
`audience.deleted`	`audience`	Une liste a été supprimée.
`subscriber.created`	`subscriber`	Un contact a été ajouté à une liste.
`subscriber.updated`	`subscriber`	Un abonné a été modifié, y compris lorsqu’il se désinscrit de la liste ou s’y réinscrit.
`subscriber.deleted`	`subscriber`	Un contact a été retiré d’une liste, y compris lorsque le contact a été supprimé.
`subscriber.resubscribed`	`subscriber`	Un contact désinscrit a de nouveau été ajouté à la liste. Envoyé en même temps que `subscriber.updated`. Absent du sélecteur.

Les objets abonné contiennent subscribed, subscribed_at, unsubscribed_at, la liste audience (id, name) et le contact contact (id, email, noms et champs personnalisés).

Événements de contact, de modèle et de blocage

Événement	Objet	Déclenché lorsque
`contact.created`	`contact`	Un contact a été créé.
`contact.updated`	`contact`	Les champs, les champs personnalisés ou les listes d’un contact ont changé.
`contact.deleted`	`contact`	Un contact a été supprimé.
`template.created`	`template`	Un modèle, ou une nouvelle version de modèle, a été créé.
`template.updated`	`template`	Un modèle a été modifié ou publié.
`template.deleted`	`template`	Un modèle a été supprimé.
`suppression.created`	`suppression`	Un blocage a été ajouté dans le tableau de bord, via l’API, par import CSV ou par une automatisation.
`suppression.updated`	`suppression`	Le motif ou la date d’expiration d’un blocage a changé.
`suppression.deleted`	`suppression`	Un blocage a été supprimé.

Les blocages que la chaîne de livraison ajoute automatiquement après un rebond ou une plainte ne déclenchent pas suppression.created. Pour les suivre, écoutez email.bounced et email.complained.

Événements de vérification d’e-mails

Événement	Objet	Déclenché lorsque
`email_verification.created`	`email_verification`	La vérification d’une adresse unique a été demandée.
`email_verification.updated`	`email_verification`	Une vérification est terminée et son résultat est disponible.
`email_verification_list.created`	`email_verification_list`	Une liste de vérification a été créée.
`email_verification_list.updated`	`email_verification_list`	Le traitement d’une liste est terminé. Contient `status` et `stats`.

Le sélecteur du tableau de bord propose aussi email_verification.deleted et email_verification_list.deleted. Emailit n’envoie pas ces événements.

Événements de campagne

Les événements de campagne ne figurent pas dans le sélecteur du tableau de bord. Ils parviennent aux webhooks dont l’option All events est activée, ou vous pouvez les ajouter via l’API. Chacun contient un objet campaign avec id, name, status, subject, from_email, from_name, scheduled_at, sent_at et created_at. Les changements de statut contiennent aussi previous_status.

Événement	Déclenché lorsque
`campaign.created`	Une campagne a été créée.
`campaign.updated`	Le contenu, l’expéditeur ou les destinataires d’une campagne ont changé.
`campaign.deleted`	Une campagne a été supprimée.
`campaign.scheduled`	Une campagne a été programmée pour une date ultérieure.
`campaign.queued`	Une campagne programmée a atteint son heure d’envoi et a été mise en file d’attente.
`campaign.sending`	L’envoi d’une campagne a commencé.
`campaign.testing`	Une campagne est passée au statut `testing`.
`campaign.sent`	L’envoi d’une campagne est terminé.
`campaign.canceled`	Une campagne a été annulée.
`campaign.archived`	Une campagne a été archivée.

Noms d’événements obsolètes

Le groupe Deprecated du sélecteur du tableau de bord liste des noms issus d’une ancienne version d’Emailit : email.sent, email.opened, email.softfail, email.hardfail, email.error, email.delayed et email.processed. Ils ne sont plus envoyés. Utilisez plutôt email.delivered, email.loaded, email.attempted et email.bounced.

Requêtes de webhook

L’enveloppe qui entoure chaque événement.

Configurer un webhook

Choisissez les événements et les filtres.