Erste eingehende E-Mail empfangen

Dieser Schnellstart richtet eine Domain für den Empfang von E-Mails ein, damit Ihre App Antworten, Supportanfragen oder weitergeleitete Nachrichten verarbeiten kann. Sie legen einen DNS-Eintrag an, senden eine Testnachricht, empfangen sie dann mit einem Webhook und rufen ihren vollständigen Inhalt über die API ab.

Voraussetzungen

• Eine verifizierte Versanddomain, etwa acme.com. Eingehende E-Mails funktionieren nur auf Domains, die in Ihrem Workspace verifiziert sind. Siehe Versanddomain hinzufügen.
• Credits im Workspace. Jede empfangene E-Mail kostet 1 Credit.

So funktionieren Inbound-Adressen

Emailit empfängt E-Mails auf einer Subdomain Ihrer Versanddomain, standardmäßig inbound. Jede Adresse auf dieser Subdomain funktioniert; support@inbound.acme.com und reply-4821@inbound.acme.com kommen also beide im selben Workspace an. Die MX-Einträge Ihrer Hauptdomain, etwa für Google Workspace oder Microsoft 365, bleiben unverändert.

Inbound-MX-Eintrag anlegen

1. Domain öffnen. Öffnen Sie Email API›Domains und dann acme.com. Der MX-Eintrag für inbound.acme.com steht zusammen mit den anderen DNS-Einträgen. Er ist optional; die Domain bleibt auch ohne ihn verifiziert.

2. Eintrag bei Ihrem DNS-Anbieter anlegen.

   Typ	Name	Wert	Priorität
   MX	inbound.acme.com	inbound.emailitmail.com	10

   Manche DNS-Anbieter erwarten im Namensfeld nur inbound, andere den vollständigen Namen.

3. DNS prüfen. Wählen Sie auf der Domainseite Check DNS und warten Sie, bis der Inbound-Eintrag OK anzeigt. DNS-Änderungen dauern meist einige Minuten, können aber bis zu 48 Stunden brauchen.

Um auf einer anderen Subdomain zu empfangen, etwa replies.acme.com, setzen Sie inbound_key auf replies, wenn Sie die Domain per API erstellen oder aktualisieren, und legen Sie dann stattdessen den MX-Eintrag für diesen Namen an. Die Weboberfläche zeigt die Inbound-Subdomain an, lässt Sie sie aber nicht ändern.

Test-E-Mail senden

Senden Sie aus Ihrem persönlichen Postfach eine E-Mail an eine beliebige Adresse auf der Inbound-Subdomain, zum Beispiel hello@inbound.acme.com.

Öffnen Sie Email API›Emails und dann den Tab Incoming. Die Nachricht erscheint mit dem Status received. Öffnen Sie sie, um Absender, Header, Inhalt und eventuelle Anhänge zu sehen.

Wenn sie nicht ankommt, prüfen Sie, ob der MX-Eintrag OK anzeigt und die Domain verifiziert ist. Hat der Workspace keine Credits mehr, lehnt Emailit die Nachricht mit einem vorübergehenden Fehler ab, und der Server des Absenders versucht es später erneut.

Per Webhook benachrichtigt werden

Um eingehende E-Mails in Ihrer App zu verarbeiten, abonnieren Sie das Event email.received.

1. Webhook erstellen. Öffnen Sie Email API›Webhooks, wählen Sie Add webhook und geben Sie einen Namen und Ihren HTTPS-Endpunkt ein, zum Beispiel https://acme.com/webhooks/emailit. Kopieren Sie das Webhook-Secret. Sie brauchen es, um Signaturen zu verifizieren.

2. Event wählen. Ein neuer Webhook empfängt alle Events. Öffnen Sie den Tab Settings des Webhooks und wählen Sie nur email.received, oder behalten Sie alle Events und filtern Sie in Ihrem Code.

3. Senden Sie eine weitere Test-E-Mail an hello@inbound.acme.com.

Emailit sendet ein signiertes POST an Ihren Endpunkt. Der Body ist ein JSON-Array, weil eine Anfrage bis zu 100 Events enthalten kann:

[
  {
    "event_id": "evt_2pXb7Lw9QmKc4RtN8yVd3Hs",
    "type": "email.received",
    "data": {
      "object": {
        "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
        "object": "email",
        "from": "ada@example.com",
        "to": "hello@inbound.acme.com",
        "subject": "Question about my order",
        "created_at": "2026-10-01T09:30:12.418Z"
      }
    }
  }
]

Das Event enthält Absender, Empfänger und Betreff, aber nicht den Inhalt. Verifizieren Sie den Header X-Emailit-Signature, bevor Sie der Anfrage vertrauen. Siehe Anfragesignatur.

Vollständige E-Mail abrufen

Rufen Sie die Nachricht mit der id aus dem Event und einem API-Schlüssel mit Full Access ab:

curl https://api.emailit.com/v2/emails/em_2pXb7Kq4NvL8mWc3RtB9yZd \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Die Antwort enthält die geparsten Header, den Text- und HTML-Inhalt sowie die Anhänge:

{
  "object": "email",
  "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
  "type": "inbound",
  "from": "ada@example.com",
  "to": "hello@inbound.acme.com",
  "subject": "Question about my order",
  "status": "received",
  "headers": { "...": "..." },
  "body": {
    "text": "Hi, where is my order #1042?",
    "html": "<p>Hi, where is my order #1042?</p>"
  },
  "attachments": []
}

Um stattdessen die Originalnachricht zu erhalten, rufen Sie GET /emails/{id}/raw auf. Nachrichteninhalte werden für die Aufbewahrungsdauer Ihres Tarifs gespeichert; rufen Sie sie also bald nach dem Eintreffen des Events ab. Siehe Datenaufbewahrung.

Preise

Jede empfangene E-Mail kostet 1 Credit, genauso viel wie eine gesendete. Siehe Credits.

Nächste Schritte