Webhooks voor verzonden e-mails

Bij het versturen van transactionele e-mails is het belangrijk om te weten of je e-mails succesvol zijn afgeleverd, of dat er problemen zijn opgetreden. Daarom introduceren we webhooks, waarmee je direct meldingen kunt ontvangen in je applicatie(s).

We ondersteunen de volgende meldingen:

E-mail is gemaakt (Message Created)
E-mail is verzonden (Message Sent)
E-mail is afgeleverd (Message Delivered)
E-mail niet afgeleverd wegens een Hard Bounce (Message Hard Bounced)
E-mail niet afgeleverd wegens een Soft Bounce (Message Soft Bounced)
Spammelding (Spam Complaint)
E-mail niet afgeleverd (Message Failed)

Hoe werkt het?

Om te starten met webhooks, ga je naar je projectinstellingen en klik je op het project waarvoor je webhooks wilt inschakelen. Vervolgens ga je naar de Route waarvoor je webhooks wilt inschakelen en klik je op het tabblad Webhooks.

Klik op de knop Create webhook en vul de gewenste URL in waar je de meldingen wilt ontvangen. Maak daarnaast ook een keuze welke meldingen je wilt ontvangen. Met de Test Webhook knop kun je direct een testmelding (webhook.test) versturen naar de opgegeven URL om te controleren of alles correct werkt.

Je kunt meerdere webhooks aanmaken voor verschillende URL's en meldingen.

Een voorbeeld van een webhook voor een gemaakte e-mail (Message Created) ziet er als volgt uit:

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"
  }
}

Je ontvangt een POST-verzoek op de opgegeven URL met de JSON payload van de gebeurtenis.

Voor de volledige documentatie webhooks en de mogelijkheden kun je onze webhooks documentatie bekijken.