# E-mail lezen vanuit je app

> Laat een app antwoorden, bestellingen of supportmail ophalen uit een veldhost-mailbox via IMAP met een Email API-sleutel.

Source: https://veldhost.eu/nl/docs/read-email-from-your-app

Last verified: 2026-11-16

Je app leest een mailbox via IMAP, ingelogd met een Email API-sleutel die **Read mail** of **Change mail** mag. Gebruik dit om antwoorden, binnenkomende bestellingen of supportvragen op te halen.

## Voordat je begint

[Maak een Email API-sleutel](https://veldhost.eu/docs/email-api-keys) op de mailbox en kies wat de app nodig heeft:

- **Read mail**: de app kan berichten en bijlagen opsommen, doorzoeken en downloaden. Hij verandert niets: berichten blijven ongelezen, niets wordt verplaatst of verwijderd. Opdrachten die iets zouden veranderen, doen niets of worden geweigerd.
- **Change mail**: alles wat **Read mail** kan, plus berichten als gelezen markeren of een vlag geven, ze tussen mappen verplaatsen, ze verwijderen en concepten opslaan. Kies dit als de app moet markeren wat hij al verwerkt heeft.

## Instellingen

| Instelling | Waarde |
|---|---|
| Server | imap.veldhost.eu |
| Poort | 993 |
| Beveiliging | SSL/TLS |
| Gebruikersnaam | het mailboxadres |
| Wachtwoord | de Email API-sleutel |

Email API-sleutels loggen alleen in via IMAP. POP3, mailfilters (ManageSieve), agenda's en contacten accepteren ze niet.

## Voorbeelden

`MAILBOX` is het mailboxadres en `KEY` de Email API-sleutel, `IMAP_HOST` staat voor imap.veldhost.eu en `IMAP_PORT` voor 993.

**Python** (nieuwe mail lezen en als verwerkt markeren; vraagt **Change mail**):

```python
import imaplib, os, email

with imaplib.IMAP4_SSL("IMAP_HOST", IMAP_PORT) as imap:
    imap.login("MAILBOX", os.environ["EMAIL_API_KEY"])
    imap.select("INBOX")
    _, ids = imap.search(None, "UNSEEN")
    for num in ids[0].split():
        _, data = imap.fetch(num, "(RFC822)")
        message = email.message_from_bytes(data[0][1])
        print(message["From"], message["Subject"])
        imap.store(num, "+FLAGS", "\\Seen")
```

Met een **Read mail**-sleutel open je de mailbox alleen-lezen (`imap.select("INBOX", readonly=True)`) en houd je zelf bij wat je verwerkt hebt, bijvoorbeeld aan de hand van de UID van het bericht.

**Node.js** (imapflow):

```js
const client = new ImapFlow({ host: 'IMAP_HOST', port: IMAP_PORT, secure: true,
  auth: { user: 'MAILBOX', pass: process.env.EMAIL_API_KEY } });
await client.connect();
const lock = await client.getMailboxLock('INBOX');
try {
  for await (const msg of client.fetch({ seen: false }, { envelope: true })) {
    console.log(msg.envelope.from[0].address, msg.envelope.subject);
  }
} finally { lock.release(); await client.logout(); }
```

**PHP**: elke IMAP-bibliotheek (bijvoorbeeld webklex/php-imap) met de instellingen hierboven.

## Goede gewoonten

- Kijk elke minuut of twee of er nieuwe mail is, of houd één verbinding open en gebruik IDLE. Log niet voor elk bericht opnieuw in.
- Lezen via IMAP zit in je abonnement en wordt niet gefactureerd.
- Download grote bijlagen één keer en bewaar ze; haal hetzelfde bericht niet steeds opnieuw op.

## Gerelateerd

- [Email API-sleutels](https://veldhost.eu/docs/email-api-keys)
- [E-mail versturen vanuit je app](https://veldhost.eu/docs/send-email-from-your-app)
- [Prijzen van de Email API](https://veldhost.eu/docs/email-api-pricing)