# Die /emails-Endpunkte der API v2 sind da

> Versenden, abrufen, aktualisieren und stornieren Sie E-Mails programmatisch mit den neuen E-Mail-Endpunkten der API v2.

2026-01-19 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Wir freuen uns, Ihnen mitzuteilen: **Die E-Mail-Endpunkte sind jetzt in der API v2 verfügbar!** Sie können E-Mails versenden und abrufen, geplante E-Mails ändern und ausstehende E-Mails stornieren, alles über unsere leistungsstarke REST-API.

## Neue Endpunkte

### E-Mail versenden

```
POST /v2/emails
```

Versenden Sie eine einzelne E-Mail an einen oder mehrere Empfänger. Der Versand-Endpunkt unterstützt:

- **Mehrere Empfänger** – Versand an bis zu 50 Empfänger (TO, CC, BCC zusammen)
- **Vorlagen** – Verwenden Sie Aliase oder IDs von Vorlagen mit Variablenersetzung über die `{{variable}}`-Syntax
- **Anhänge** – Dateien als Base64-Inhalt oder per URL einbinden
- **Zeitplanung** – E-Mails für eine spätere Zustellung planen, per ISO 8601, Unix-Zeitstempel oder natürlicher Sprache wie „tomorrow at 9am“
- **Tracking** – Die Tracking-Standards der Domain für Öffnungen und Klicks übersteuern
- **Metadaten** – Eigene Schlüssel-Wert-Paare anhängen, die gespeichert und mit der E-Mail zurückgegeben werden
- **Idempotenz** – Doppelte Versände mit dem Header `Idempotency-Key` verhindern

Beim Versand an mehrere Adressen erhält jeder Empfänger eine eigene, eindeutige E-Mail-ID für individuelles Tracking.

### E-Mail abrufen

```
GET /v2/emails/{id}
```

Rufen Sie detaillierte Informationen zu einer bestimmten E-Mail ab, darunter:

- Aktueller Status (ausstehend, geplant, gesendet, zugestellt, gebounct, storniert)
- Unveränderte E-Mail-Header und Inhalte
- Tracking-Einstellungen
- Eigene Metadaten
- Zeitstempel für Erstellung und Aktualisierungen

### Geplante E-Mail aktualisieren

```
POST /v2/emails/{id}
```

Planen Sie eine E-Mail neu, die für eine spätere Zustellung vorgesehen ist. Sie können den geplanten Zeitpunkt ändern, solange bis zum Versand noch mindestens 3 Minuten bleiben.

### E-Mail stornieren

```
POST /v2/emails/{id}/cancel
```

Stornieren Sie eine geplante oder ausstehende E-Mail, bevor sie versendet wird. Bei geplanten E-Mails muss die Stornierung mindestens 3 Minuten vor der geplanten Versandzeit angefordert werden.

## Rate Limits

Jede Antwort enthält Rate-Limit-Header, damit Sie Ihre Nutzung überwachen können:

- `ratelimit-limit` – Maximale Anfragen pro Sekunde
- `ratelimit-remaining` – Verbleibende Anfragen in der aktuellen Sekunde
- `ratelimit-daily-limit` – Maximale tägliche Anfragen
- `ratelimit-daily-remaining` – Verbleibende tägliche Anfragen

## Dokumentation

Die vollständige Dokumentation mit Codebeispielen in Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET und cURL finden Sie hier:

- [E-Mail versenden](https://emailit.com/docs/api-reference/emails/send)
- [E-Mail abrufen](https://emailit.com/docs/api-reference/emails/get)
- [Geplante E-Mail aktualisieren](https://emailit.com/docs/api-reference/emails/update)
- [E-Mail stornieren](https://emailit.com/docs/api-reference/emails/cancel)

## Demnächst: die Vorlagen-API

Wir arbeiten an der **Vorlagen-API (Templates API)**, mit der Sie E-Mail-Vorlagen programmatisch erstellen, aktualisieren und verwalten können. Seien Sie gespannt!

## Hinweis zur Abkündigung der API v1

**Wichtig:** Die API v1 ist abgekündigt und funktioniert ab Ende Februar 2026 nicht mehr. Falls Sie noch die API v1 verwenden, migrieren Sie bitte so bald wie möglich auf die API v2.

Sie brauchen Hilfe bei der Migration? Werfen Sie einen Blick in die [Dokumentation der API v2](https://emailit.com/docs/api-reference) oder wenden Sie sich an unser Support-Team.

---

Source: https://emailit.com/de/blog/api-v2-emails-endpoints/