> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kommunikation/e-mail/mailgun-api-schlussel-fur-deinen-e-mail-versand-einrichten.md). # Mailgun-API-Schlüssel für deinen E-Mail-Versand einrichten ## Kurz erklärt Mit dem privaten API-Schlüssel von Mailgun verbindest du eine bereits verifizierte Versanddomain mit deinem ONE LOOP Standort. Danach kannst du diese Domain in den E-Mail-Diensteinstellungen auswählen, E-Mails zuverlässig versenden und Antworten über die eingerichtete Empfangsroute verarbeiten. Der Schlüssel ist ein geheimer Zugang. Gib ihn nie in Tickets, Chat-Nachrichten oder Screenshots weiter. ## Voraussetzungen * Du hast ein Mailgun-Konto mit mindestens einer verifizierten Versanddomain. * Die DNS-Einträge der Versanddomain sind vollständig eingerichtet: SPF, DKIM, MX und – falls genutzt – der CNAME für Link-Tracking. * Die Domain ist bei Mailgun in der US-Region angelegt und als verifiziert markiert. * Du kannst in deinem ONE LOOP Standort die **E-Mail-Diensteinstellungen** öffnen. * Falls bei Mailgun eine IP-Positivliste aktiv ist, kannst du sie für die Verbindung vorübergehend anpassen. ## Vor dem Verbinden Richte den Schlüssel erst ein, wenn deine Versanddomain in Mailgun als verifiziert angezeigt wird. Die Verbindung liest nur verifizierte Domains aus dem **US**-Bereich ein. Eine Domain aus dem EU-Bereich oder eine noch nicht bestätigte Domain erscheint deshalb nicht zur Auswahl. Der **Private API Key** ist ein geheimer Zugang zu deinem Mailgun-Konto. Kopiere ihn nur direkt in das dafür vorgesehene Feld. Speichere ihn nicht in Notizen, E-Mails oder Screenshots und sende ihn niemals an andere Personen. Wenn du vermutest, dass der Schlüssel bekannt geworden ist, erstelle einen neuen und ersetze den bisherigen Schlüssel. Lege vor dem Speichern fest, welche Versanddomain du anschließend auswählen möchtest. So kannst du direkt erkennen, ob die Verbindung die erwartete Domain geladen hat. ## Schritt für Schritt 1. Melde dich bei Mailgun an und öffne oben rechts dein Profil. 2. Wähle **API Security**. 3. Kopiere einen vorhandenen **Private API Key** oder lege einen neuen privaten Schlüssel an. 4. Öffne in deinem ONE LOOP Standort die **E-Mail-Diensteinstellungen**. 5. Wähle Mailgun als E-Mail-Dienst aus. 6. Füge den privaten API-Schlüssel ein und speichere die Verbindung. 7. Wähle anschließend die verifizierte Versanddomain aus der Domain-Auswahl aus. 8. Speichere die Einstellungen. 9. Sende eine Test-E-Mail an eine Adresse, auf die du Zugriff hast. ## Ergebnis prüfen Prüfe diese Punkte direkt nach dem Speichern: * Deine verifizierte Versanddomain erscheint in der Domain-Auswahl. * Die Domain ist bei Mailgun als verifiziert markiert. * Die Test-E-Mail wird zugestellt. * Wenn eine Empfangsroute eingerichtet ist, werden Antworten dem richtigen Kontakt im ONE LOOP Standort zugeordnet. ## Praxisbeispiel Du nutzt bereits die Versand-Subdomain `mg.beispiel-firma.de` und sie ist in Mailgun als verifiziert markiert. Du öffnest dort **API Security**, kopierst einen neu angelegten privaten Schlüssel und fügst ihn unmittelbar in die E-Mail-Diensteinstellungen deines ONE LOOP Standorts ein. Nach dem Speichern erscheint `mg.beispiel-firma.de` in der Domain-Auswahl. Du wählst sie aus, speicherst erneut und schickst eine E-Mail an deine eigene Testadresse. Erst wenn diese Nachricht ankommt, ist die Umstellung abgeschlossen. ## Häufige Fehler ### Die Domain erscheint nicht in der Auswahl Prüfe zuerst die Region: Es werden nur verifizierte Mailgun-Domains aus der US-Region übernommen. Eine Domain aus der EU-Region erscheint nicht in der Auswahl. Kontrolliere danach, ob die Domain bei Mailgun wirklich als verifiziert markiert ist. Bei einer IP-Positivliste kann die Domain-Synchronisierung blockiert sein. Passe die Positivliste nur so weit wie nötig an und stelle die gewünschte Einschränkung nach der Prüfung wieder her. ### Ich habe den öffentlichen Schlüssel eingefügt Für die Verbindung brauchst du den **Private API Key**. Ein öffentlicher Schlüssel authentifiziert den E-Mail-Dienst nicht. ### Nach einem Schlüsselwechsel funktioniert der Versand nicht mehr Erstelle in Mailgun einen neuen privaten Schlüssel, hinterlege ihn in den E-Mail-Diensteinstellungen und speichere erneut. Teste danach den Versand. Widerrufe einen alten Schlüssel erst, wenn der neue Schlüssel erfolgreich funktioniert. ### Die Test-E-Mail kommt nicht an Prüfe nacheinander die Verifizierung der Domain, die DNS-Einträge, den eingefügten privaten Schlüssel und die gewählte Versanddomain. Prüfe außerdem den Spam-Ordner der Empfängeradresse. ## Gut zu wissen * Eine Versanddomain muss vor der Auswahl bei Mailgun verifiziert sein. * Ein privater Schlüssel kann aus Sicherheitsgründen regelmäßig gewechselt werden. Aktualisiere ihn danach immer auch im ONE LOOP Standort. * Nutze für unterschiedliche Bereiche getrennte Subdomains, wenn du Versand und E-Mail-Empfang klar voneinander trennen möchtest. * Änderungen an DNS, API-Schlüssel oder Versanddomain sollten immer mit einer Test-E-Mail überprüft werden. ## Klicks und Öffnungen für eine Mailgun-Domain auswerten Damit du Öffnungen, Linkklicks, Abmeldungen, Unzustellbarkeiten und Spam-Beschwerden im Standort auswerten kannst, braucht jede verwendete Mailgun-Versanddomain zwei Einstellungen: die Ereignisweitergabe und das Tracking direkt an der Domain. ### Ereignisse pro Versanddomain weitergeben Die Ereignisweitergabe wird in Mailgun auf **Domain-Ebene** eingerichtet. Öffne dort **Send** → **Webhooks**, wähle den Tab für die Versanddomain und füge eine neue Ereignisweitergabe hinzu. * Gib ihr eine klare Bezeichnung, etwa „E-Mail-Ereignisse Standort“. * Verwende ausschließlich die für den Standort vorgesehene Ereignisadresse. Ist sie in deinen Verbindungsdaten nicht hinterlegt, fordere sie beim ONE LOOP Support an; verwende keine frei erfundene oder fremde Adresse. * Wähle die richtige Versanddomain. * Aktiviere alle Ereignistypen: angenommen, zugestellt, geöffnet, geklickt, dauerhafter oder vorübergehender Fehler, Spam-Beschwerde und Abmeldung. * Teste die Erreichbarkeit, wenn Mailgun eine Testfunktion anbietet, und speichere anschließend. Eine Einrichtung gilt immer nur für die ausgewählte Domain. Wiederhole sie daher für jede weitere Versanddomain. ### Link- und Öffnungs-Tracking aktivieren 1. Öffne in Mailgun **Send** → **Domains** und wähle die Versanddomain. 2. Öffne **Settings** und den Bereich für Tracking. 3. Aktiviere Link-Tracking und Öffnungs-Tracking. 4. Stelle sicher, dass das Tracking über HTTPS läuft und das Tracking-Zertifikat aktiv ist. 5. Speichere jede Änderung. Für das Link-Tracking muss der von Mailgun verlangte CNAME-Eintrag im DNS der Domain vorhanden sein. Solange das Zertifikat nicht aktiv ist, fehlt der Eintrag möglicherweise noch oder die DNS-Änderung ist noch nicht weltweit übernommen. Linkziele können dann nicht zuverlässig funktionieren. ### Ergebnis prüfen 1. Sende eine Test-E-Mail mit mindestens einem Link an eine eigene Testadresse. 2. Öffne die E-Mail und wähle den Link aus. 3. Prüfe in Mailgun die Übermittlung der Ereignisse. 4. Prüfe anschließend die E-Mail-Kennzahlen im Standort. 5. Wiederhole den Test für jede Versanddomain. Fehlen Öffnungen oder Klicks, kontrolliere zuerst, ob Tracking wirklich aktiviert ist und die Ereignisweitergabe für die Domain – nicht nur auf Kontoebene – eingerichtet wurde. Bei einem fehlerhaften Test kontrollierst du die Zieladresse Zeichen für Zeichen und öffnest die Fehlerprotokolle in Mailgun. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kommunikation/e-mail/mailgun-api-schlussel-fur-deinen-e-mail-versand-einrichten.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.