# E-Mail-Versand mit SendGrid einrichten

Du erzeugst bei SendGrid einen API-Key, hinterlegst ihn unter Anbindungen und überwachst Status und authentifizierte Domains danach direkt in MainPath.

> Source: https://www.mainpath.ai/de/docs/smtp-sendgrid-setup/

SendGrid ist in MainPath als eigener Anbindungstyp integriert. Du hinterlegst nur einen API-Key; den Versand über SMTP (`smtp.sendgrid.net`, Benutzer `apikey`), die Statusanzeige und die Überwachung deiner authentifizierten Domains übernimmt MainPath.

```mermaid
flowchart LR
  cred["SendGrid-Anbindung der Organisation"]
  svc["Backend deines Projekts"]
  api["SendGrid API / SMTP"]
  mx["Mailserver des Empfängers"]
  svc -->|"liest Zugangsdaten"| cred
  svc -->|"API-Key"| 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 SendGrid vorbereiten

1. Lege unter [sendgrid.com](https://sendgrid.com/) ein Konto an oder melde dich an.
2. Trage unter **Settings → Sender Authentication** 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 MainPath heraus erledigen.
3. Erstelle unter **Settings → API Keys** einen Key mit **Mail Send** und Rechten für Domain Authentication und kopiere ihn.

Derselbe API-Key gilt als SMTP-Passwort. Der SMTP-Benutzer ist immer `apikey`.

## Anbindung in MainPath anlegen

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

## Status und Domains in MainPath überwachen

Die Kachel der SendGrid-Anbindung öffnet die Detailansicht mit dem **Status** der Verbindung, deinen authentifizierten 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 SendGrid-Zugang aus. SendGrid-, Resend-, Mailtrap- und SMTP-Zugänge stehen dort gemeinsam zur Auswahl.

## Wenn etwas nicht funktioniert

Zeigt der **Status** einen Fehler, prüfe den API-Key und erzeuge bei SendGrid gegebenenfalls einen neuen. Lehnt SendGrid den Versand ab oder kommen Mails nicht an, ist die Domain meist noch nicht authentifiziert; 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.

## Siehe auch

- [Anbindungen]({{< relref "connections" >}})
- [E-Mail-Versand]({{< relref "email-delivery" >}})
- [SMTP mit Mailtrap]({{< relref "smtp-mailtrap-setup" >}})
- [SMTP mit Resend]({{< relref "smtp-resend-setup" >}})