# E-Mail-Versand mit Mailtrap einrichten

Du erzeugst bei Mailtrap ein API-Token, hinterlegst es unter Anbindungen und überwachst Status und Sending Domains danach direkt in der Plattform.

> Source: https://www.application-platform.com/de/docs/smtp-mailtrap-setup/

Mailtrap ist in der Plattform als eigener Anbindungstyp integriert. Du hinterlegst nur ein API-Token; den Versand über die Sending API, die Statusanzeige und die Überwachung deiner Sending Domains übernimmt die Plattform.

```mermaid
flowchart LR
  cred["Mailtrap-Anbindung der Organisation"]
  svc["Backend deines Projekts"]
  api["Mailtrap Sending API"]
  mx["Mailserver des Empfängers"]
  svc -->|"liest Zugangsdaten"| cred
  svc -->|"API-Token"| api
  api --> mx
```

Für einen anderen Anbieter legst du stattdessen einen generischen Zugang **E-Mail (SMTP)** an; die Unterschiede beschreibt [E-Mail-Versand]({{< relref "email-delivery" >}}).

## Bei Mailtrap vorbereiten

1. Lege unter [mailtrap.io](https://mailtrap.io/) ein Konto an oder melde dich an.
2. Trage unter **Sending Domains** deine Absender-Domain ein und setze die angezeigten DNS-Einträge für SPF, DKIM und DMARC bei deinem Domain-Anbieter; erst nach der Verifizierung ist der Versand freigeschaltet. Diesen Schritt kannst du auch später aus der Plattform heraus erledigen.
3. Erstelle unter **Settings → API Tokens** ein Sending-API-Token und kopiere es.

## Anbindung in der Plattform anlegen

1. Öffne **Anbindungen** in der Seitenleiste und klicke auf **Anbindung hinzufügen**.
2. Wähle die Kachel **Mailtrap**.
3. Trage das **API-Token** ein, optional dazu **Absendername** und eine **Absender-Adresse** aus deiner verifizierten Sending Domain.
4. Speichere. Der Zugang steht danach in den Projekten unter **Mail-Account** zur Auswahl.

## Status und Domains in der Plattform überwachen

Die Kachel der Mailtrap-Anbindung öffnet die Detailansicht mit dem **Status** der Verbindung, Plan und Sendevolumen deines Mailtrap-Kontos, deinen Sending Domains mit Verifizierungsstatus und je Domain den DNS-Einträgen mit Typ, Name, Wert und Prüfstatus. Über **Domain hinzufügen** legst du neue Sending Domains direkt hier an.

## Mail-Account im Projekt wählen

Beim Bearbeiten des Projekts wählst du in den Einstellungen des Backends unter **Mail-Account** den Mailtrap-Zugang aus. Mailtrap- und SMTP-Zugänge stehen dort gemeinsam zur Auswahl.

## Wenn etwas nicht funktioniert

Zeigt der **Status** einen Fehler, prüfe das API-Token und erzeuge bei Mailtrap gegebenenfalls ein neues. Lehnt Mailtrap den Versand ab oder kommen Mails nicht an, ist die Sending Domain meist noch nicht verifiziert; vergleiche dann die DNS-Einträge in der Detailansicht mit denen bei deinem Domain-Anbieter. Fehlt eine Domain in der Liste, legst du sie über **Domain hinzufügen** an und setzt die angezeigten Einträge.