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.
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.
Bei SendGrid vorbereiten
- Lege unter sendgrid.com ein Konto an oder melde dich an.
- 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.
- 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
- Öffne Anbindungen in der Seitenleiste und klicke auf Anbindung hinzufügen.
- Wähle die Kachel SendGrid.
- Trage den API-Key ein, optional dazu Absendername und eine Absender-Adresse aus deiner authentifizierten Domain.
- 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.