# So funktioniert Emailit

> Das Grundmodell von Emailit auf einer Seite. Workspaces, Domains und API-Schlüssel, die Wege zum Senden und Empfangen, der Lebenszyklus einer E-Mail, Credits und Sandbox-Modus.

Diese Seite erklärt die wichtigsten Bausteine von Emailit und wie sie zusammenhängen. Lesen Sie sie einmal, bevor Sie etwas bauen. Der Rest der Doku setzt diese Begriffe voraus.

## Konten und Workspaces

Ihr **Konto**, das sind Sie: eine E-Mail-Adresse, ein Passwort und optional Zwei-Faktor-Authentifizierung oder Passkeys. Alles, was Sie senden, liegt in einem Workspace. Ein Konto kann mehreren Workspaces angehören, und Sie wechseln mit dem Workspace-Umschalter oben in der Seitenleiste zwischen ihnen. Üblich ist ein Workspace pro Produkt oder pro Umgebung, zum Beispiel `Acme` und `Acme Staging`.

Jeder Workspace hat eigene:

| Ressource | Was sie ist |
| --- | --- |
| Versanddomains | Domains, die Sie mit DNS-Einträgen verifizieren, damit Emailit für sie senden kann. Jede Absenderadresse muss auf einer verifizierten Versanddomain liegen. |
| API-Schlüssel | Secrets, die mit `secret_` beginnen. Sie authentifizieren die REST-API, den MCP-Server und das SMTP-Relay. Ein Schlüssel hat entweder **Full Access** oder **Sending Only**. |
| Mitglieder | Die Personen, die den Workspace öffnen können, als **Admin** oder **Member**. Admins verwalten außerdem Einstellungen, API-Schlüssel, Mitglieder und Abrechnung. |
| Abrechnung | Ein Tarif, ein Guthaben an Credits, Einstellungen der automatischen Aufladung und Rechnungen. |
| Daten | E-Mails, Events, Logs, Kontakte, Kontaktlisten, Vorlagen, Webhooks und Sperrungen. |

API-Schlüssel, Domains, Kontakte und Credits gehören zu genau einem Workspace. Ein API-Schlüssel funktioniert nie in einem anderen Workspace.

## Wege zum Senden und ein Weg zum Empfangen

| Kanal | Geeignet für | Wie |
| --- | --- | --- |
| REST-API | Transaktionale E-Mails aus Ihrem Code: Registrierungen, Passwort-Resets, Belege | `POST https://api.emailit.com/v2/emails` mit einem API-Schlüssel oder einem [SDK](/de/docs/sdks/) |
| SMTP-Relay | Apps, Frameworks und Tools, die bereits SMTP sprechen | Host `smtp.emailit.com`, Benutzername `emailit`, Ihr API-Schlüssel als Passwort |
| Kampagnen und Automatisierungen | Newsletter, Ankündigungen und Onboarding-Sequenzen an Ihre Kontakte | In der Weboberfläche unter **Email Marketing** erstellt |
| Eingehende E-Mails | Empfang von E-Mails auf Ihrer Domain, für Antworten oder Support | Ein MX-Eintrag auf `inbound.<your domain>`. Jede Nachricht löst `email.received` aus. |

Jeder Kanal verwendet dieselben verifizierten Domains und dieselbe Sperrliste. API und SMTP-Relay teilen sich außerdem API-Schlüssel, Anfrage-Logs und einen gemeinsamen Satz von Versandlimits. Wie Sie zwischen beiden wählen, erfahren Sie unter [API oder SMTP](/de/docs/get-started/api-or-smtp/).

## Der Lebenszyklus einer E-Mail

Jede E-Mail durchläuft denselben Weg, egal wie Sie sie senden:

1. **Angenommen.** API oder SMTP-Relay prüfen die Anfrage: einen gültigen API-Schlüssel, eine Absenderadresse auf einer verifizierten Domain, Sandbox-Regeln, Versandlimits und Credits. Jeder Empfänger wird zu einer eigenen E-Mail mit eigener `em_`-ID und dem Status `accepted`, oder `scheduled`, wenn Sie einen Sendezeitpunkt festgelegt haben. Die API löst `email.accepted` oder `email.scheduled` aus.
2. **In der Warteschlange und geprüft.** Ein Zustellprozess übernimmt die E-Mail und prüft sie erneut. Steht ein Empfänger auf Ihrer [Sperrliste](/de/docs/suppressions/), wird die E-Mail `suppressed`. Eine pausierte Domain, ein gesperrter Workspace oder ein leeres Credit-Guthaben setzen sie auf `held`.
3. **Signiert und bewertet.** Emailit signiert die Nachricht mit DKIM für Ihre Domain und setzt den Return-Path auf `emailit.<your domain>`. Ist Tracking aktiviert, schreibt Emailit Links um und fügt ein Öffnungs-Pixel hinzu. Dann führt es eine Spam-Prüfung durch. Eine Nachricht mit einem Score von 7 oder mehr wird auf `held` gesetzt, und die zutreffenden Regeln erscheinen unter **Spam Checks** auf der Seite der E-Mail.
4. **Zustellversuche.** Emailit verbindet sich mit dem Mailserver des Empfängers. Eine dauerhafte Ablehnung (eine 5xx-Antwort) setzt die E-Mail auf `bounced`. Ein vorübergehender Fehler (eine 4xx-Antwort oder ein Timeout) setzt sie auf `attempted`, und Emailit versucht es bis zu 7-mal über etwa 21 Stunden erneut, bevor es aufgibt und sie als `bounced` markiert.
5. **Zugestellt.** Der Empfangsserver hat die Nachricht angenommen, die E-Mail ist also `delivered`. Ein später eintreffender Bounce-Bericht kann sie noch auf `bounced` setzen, und eine Spam-Beschwerde vom Postfachanbieter setzt sie auf `complained`. Gebouncte Adressen und Adressen mit Beschwerden können automatisch auf Ihre Sperrliste gesetzt werden.
6. **Geöffnet und geklickt.** Hat die Domain eine verifizierte [Tracking-Subdomain](/de/docs/tracking/), setzen Öffnungen die E-Mail auf `loaded` und Klicks auf `clicked`.

Jede Statusänderung wird als **Event** erfasst. Events erscheinen auf der Seite der E-Mail und unter **Email API → Events**. Sie werden außerdem als signiertes JSON an Ihre [Webhooks](/de/docs/webhooks/) gesendet, in Batches von bis zu 100 Events pro Anfrage.

| Gruppe | Status |
| --- | --- |
| Unterwegs | `accepted`, `scheduled`, `attempted` |
| Angekommen | `delivered`, `loaded`, `clicked`, `received` (eingehend) |
| Gestoppt | `bounced`, `failed`, `rejected`, `suppressed`, `complained`, `canceled`, `held` |

Sie können eine E-Mail stornieren, solange sie `scheduled`, `accepted` oder `attempted` ist. Eine E-Mail mit `held`, `bounced`, `failed` oder `suppressed` können Sie erneut senden, nachdem Sie die Ursache behoben haben. Was jeder Status bedeutet, erfahren Sie unter [E-Mail-Status](/de/docs/logs/email-statuses/).

## Credits

Emailit rechnet in Credits ab. Jeder Workspace hat ein Guthaben aus den Credits, die jeden Monat im Tarif enthalten sind, plus allen Credits, die Sie kaufen. Inklusive Credits werden zuerst verbraucht. Gekaufte Credits verfallen nie.

| Aktion | Credits |
| --- | --- |
| E-Mail per API oder SMTP (pro Empfänger) | 1 |
| Empfangene E-Mail | 1 |
| Kampagnen-E-Mail (pro Empfänger) | 2 |
| Automatisierungsdurchlauf | 3 |
| E-Mail-Verifizierung (pro Adresse) | 5 |

Reicht das Guthaben für einen Versand nicht aus, gibt die API `402` zurück, und nichts wird gesendet. E-Mails, die ohne genügend Credits die Zustellwarteschlange erreichen, werden auf `held` gesetzt, und Sie können sie erneut senden, nachdem Sie Credits hinzugefügt haben. Aktivieren Sie die [automatische Aufladung](/de/docs/billing/auto-refill/), damit Ihre E-Mails im Produktivbetrieb nie stoppen. Tarife und Preise finden Sie unter [Credits](/de/docs/billing/credits/) und auf der [Preisseite](/pricing/).

## Sandbox und Produktionszugang

Jeder neue Workspace startet im **Sandbox-Modus**. Im Sandbox-Modus können Sie nur an die Konto-E-Mail-Adressen der Workspace-Mitglieder senden, und Kampagnen sind blockiert. Das Senden an andere Adressen schlägt fehl: Die API gibt `403 unverified_workspace_recipient` zurück, und das SMTP-Relay antwortet mit `550`.

Um an echte Empfänger zu senden, verifizieren Sie mindestens eine Versanddomain. Dann beantragt ein Admin den Produktionszugang über das Sandbox-Banner oder unter **Workspace → Settings → Requests**. Die Anfrage fragt, was Sie senden, welches Volumen Sie erwarten und wie Personen ihr Opt-in geben. Das Emailit-Team prüft sie und antwortet im selben Anfrageverlauf. Siehe [Produktionszugang](/de/docs/workspaces/production-access/).

Jeder Workspace hat außerdem [Versandlimits](/de/docs/limits/), gemeinsam für API und SMTP. Neue Workspaces können 2 E-Mails pro Sekunde und 5.000 E-Mails pro Tag senden. Workspaces mit Pro oder Business erhalten automatische Erhöhungen auf Basis der Versandgesundheit, und jeder Workspace kann über die Karte **Sending Limits** auf der Startseite der Weboberfläche mehr beantragen.

## Die Weboberfläche

Die Weboberfläche unter [dash.emailit.com](https://dash.emailit.com) folgt demselben Modell. Die Seitenleiste enthält diese Bereiche, von oben nach unten:

| Bereich | Seite | Wofür |
| --- | --- | --- |
| Dashboard | | Checkliste zur Einrichtung, Schnellaktionen, Credits, tägliches Volumen, Versandgesundheit und Versandlimits |
| Email Marketing | Overview | Wachstum der Kontakte und aktuelle Marketing-Aktivität |
| | Audiences | Benannte Listen von Abonnenten, an die Kampagnen gehen |
| | Contacts | Alle Personen im Workspace, mit eigenen Feldern, Import und Export |
| | Campaigns | Kampagnen erstellen, testen, planen und auswerten |
| | Templates | Wiederverwendbare Designs für API, Automatisierungen und Kampagnen |
| | Forms | Anmeldeformulare (Early Access) |
| | Automations | Workflows, ausgelöst durch Kontakte, Datumsangaben und E-Mail-Events (Beta) |
| Email API | Emails | Jede ausgehende und eingehende E-Mail mit Status, Inhalt und Zustellversuchen |
| | Analytics | Versände, Bounces, Beschwerden, Öffnungen und Klicks im Zeitverlauf |
| | Domains | Domains hinzufügen, DNS-Einträge anlegen, Verifizierung und Tracking prüfen |
| | DMARC reports | Wer E-Mails als Ihre Domain sendet (ab Pro) |
| | Events | Der Event-Stream des Workspaces, den Webhooks empfangen |
| | Logs | Jede Anfrage per API und SMTP, mit Statuscodes und Bodys |
| | API Keys | Schlüssel erstellen, umbenennen, neu generieren und löschen sowie SMTP-Einstellungen ansehen |
| | Webhooks | Endpunkte, Auswahl der Events und jeder Zustellversuch |
| | Suppressions | Adressen, an die Emailit nicht sendet, mit CSV-Import und -Export |
| Email Verification | Emails | Eine einzelne Adresse vor dem Senden prüfen |
| | Lists | Bis zu 10.000 Adressen auf einmal prüfen |
| Workspace | Billing | Tarif, Credits, automatische Aufladung, Add-ons und Rechnungen |
| | Settings | Name, Mitglieder, eigene Felder, Datenaufbewahrung, Einstellungen für Sperrungen und Anfragen |

Ihre Kontoeinstellungen (Profil, Passwort, Zwei-Faktor-Authentifizierung und Passkeys) und Ihr Empfehlungslink befinden sich im Kontomenü unten in der Seitenleiste.

## Nächste Schritte

  - [Schnellstart mit der API](/de/docs/quickstart/api/): Domain hinzufügen, Schlüssel erstellen und Ihre erste E-Mail senden.
  - [Schnellstart mit SMTP](/de/docs/quickstart/smtp/): Jede App und jedes Framework per SMTP anbinden.
  - [API oder SMTP](/de/docs/get-started/api-or-smtp/): Die beiden Wege für transaktionale E-Mails vergleichen.
  - [Checkliste für den Go-live](/de/docs/get-started/go-live/): Alles, was vor dem Versand an echte Empfänger zu tun ist.

---
Quelle: https://emailit.com/de/docs/get-started/how-emailit-works/