# Email-webhooks

> Krijg een mail.received-webhook als er een bericht binnenkomt in een mailbox die je app leest, in plaats van te pollen.

Source: https://veldhost.eu/nl/docs/email-webhooks

Last verified: 2026-11-16

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](https://veldhost.eu/docs/email-api-keys) 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](https://veldhost.eu/docs/webhooks-and-integrations), 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`:

```json
{
  "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:

- via de [Email HTTP API](https://veldhost.eu/docs/email-http-api): `GET …/mail-api/messages?folder=INBOX&message_id=<the id>`;
- of via IMAP, door in de map te zoeken op de `Message-ID`-header ([E-mail lezen vanuit je app](https://veldhost.eu/docs/read-email-from-your-app)).

Controleer de handtekening en ga met nieuwe pogingen om precies zoals bij andere webhooks ([Webhooks, Slack en Teams](https://veldhost.eu/docs/webhooks-and-integrations)). 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](https://veldhost.eu/docs/email-api-pricing).

## Gerelateerd

- [Email HTTP API](https://veldhost.eu/docs/email-http-api)
- [Email API-sleutels](https://veldhost.eu/docs/email-api-keys)
- [Webhooks, Slack en Teams](https://veldhost.eu/docs/webhooks-and-integrations)