Webhooks pour les e-mails envoyés

Lors de l’envoi de transactional e-mails, il est important de savoir si vos e-mails ont bien été délivrés ou si des problèmes sont survenus.
C’est pourquoi nous introduisons les webhooks, qui vous permettent de recevoir immédiatement des notifications dans votre/vos application(s).

Nous prenons en charge les notifications suivantes :

E-mail créé (Message Created)
E-mail envoyé (Message Sent)
E-mail délivré (Message Delivered)
E-mail non délivré en raison d’un Hard Bounce (Message Hard Bounced)
E-mail non délivré en raison d’un Soft Bounce (Message Soft Bounced)
Plainte pour spam (Spam Complaint)
E-mail non délivré (Message Failed)

Comment ça marche ?

Pour commencer avec les webhooks, allez dans vos paramètres du projet et cliquez sur le projet pour lequel vous souhaitez activer les webhooks.
Ensuite, allez sur la Route pour laquelle vous voulez activer les webhooks et cliquez sur l’onglet Webhooks.

Cliquez sur le bouton Create webhook et saisissez l’URL souhaitée où vous souhaitez recevoir les notifications. Sélectionnez également les notifications que vous souhaitez recevoir. Avec le bouton Test Webhook, vous pouvez envoyer immédiatement un événement de test (webhook.test) à l’URL indiquée pour vérifier que tout fonctionne correctement.

Vous pouvez créer plusieurs webhooks pour différentes URL et notifications.

Un exemple de webhook pour un e-mail créé (Message Created) ressemble à ceci :

message_created.json

          {
  "id": "54d7e8c9-1195-4ba0-9d3f-b9af92305add",
  "event": "message.created",
  "created_at": "2025-08-08T20:14:00.000Z",
  "data": {
    "message_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "from": {
      "email": "updates@lettermint.co",
      "name": "Lettermint Updates"
    },
    "to": ["user@example.com"],
    "cc": ["cc@example.com"],
    "bcc": ["bcc@example.com"],
    "reply_to": "help@lettermint.co",
    "subject": "Welcome to Lettermint"
  }
}

Vous recevrez une requête POST à l’URL indiquée avec la charge utile JSON de l’événement.

Pour la documentation complète sur les webhooks et toutes les possibilités, consultez notre documentation webhooks.