Email-webhooks

Laatst gecontroleerd

In plaats van elke minuut in een mailbox te kijken, kan je app een seintje krijgen als er mail binnenkomt. veldhost stuurt een mail.received-webhook voor elk bericht dat wordt afgeleverd in een mailbox met een Email API-sleutel die hem mag lezen, meestal binnen een minuut of twee.

Instellen

  1. Zorg dat de mailbox een Email API-sleutel heeft met Read mail of Change mail.
  2. Voeg een webhook toe zoals beschreven in Webhooks, Slack en Teams, en vink Email received (Email API) aan.

De webhook geldt voor het hele account: hij krijgt mail.received voor elke mailbox in het account die zo'n sleutel heeft.

Wat er binnenkomt

Een ondertekende aflevering, zoals bij elke veldhost-webhook, met als data:

{
  "mailbox": "orders@example.com",
  "folder": "INBOX",
  "message_id": "<CAF3x…@mail.example.org>",
  "received_at": "2026-12-01T10:00:00Z"
}

Hij zegt waar een bericht is binnengekomen, nooit wat erin staat: geen afzender, onderwerp of inhoud. folder is de map waar de filters van de mailbox het bericht in zetten. message_id is de eigen Message-ID-header van het bericht, of null als het die niet had.

Je app haalt het bericht daarna op met zijn eigen sleutel:

Controleer de handtekening en ga met nieuwe pogingen om precies zoals bij andere webhooks (Webhooks, Slack en Teams). Wordt een bericht in twee mappen afgeleverd (door een filter dat kopieert), dan komt er één webhook per map.

Elke mail.received die je endpoint bereikt, telt als één webhook in je gebruik van de Email API.

Gerelateerd

Kom je er niet uit? Neem contact op met support — antwoord binnen één werkdag.