Zum Inhalt springen
Doku

Schnellstart

Erste E-Mail per API senden

Verifizieren Sie eine Domain, erstellen Sie einen API-Schlüssel und senden Sie Ihre erste E-Mail mit cURL oder einem offiziellen SDK für Node.js, Python, PHP, Ruby, Go, Java, .NET oder Rust.

Aktualisiert am 1. Okt. 2026

Dieser Schnellstart führt Sie in etwa fünf Minuten von einem neuen Konto zu einer zugestellten E-Mail, zuzüglich der Zeit, die Ihr DNS-Anbieter zum Veröffentlichen der Einträge braucht. Sie verifizieren eine Domain, erstellen einen API-Schlüssel, senden eine E-Mail und finden sie in der Weboberfläche.

Voraussetzungen

  • Ein Emailit-Konto. Registrieren Sie sich unter dash.emailit.com.
  • Eine Domain, für die Sie DNS-Einträge anlegen können, etwa acme.com. Sie können auch eine Subdomain verwenden, etwa mail.acme.com.

Domain hinzufügen und verifizieren

Emailit sendet nur von Domains, die Sie verifiziert haben, damit die Mailserver der Empfänger prüfen können, dass die E-Mail wirklich von Ihnen stammt.

  1. Domain hinzufügen. Öffnen Sie Email APIDomains, wählen Sie Add domain, geben Sie acme.com ein und wählen Sie Create.

  2. DNS-Einträge anlegen. Die Domainseite listet die Einträge auf, die Sie bei Ihrem DNS-Anbieter anlegen müssen. Kopieren Sie die exakten Werte von dieser Seite. Die drei erforderlichen Einträge sehen so aus:

    Typ Name Wert
    TXT emailit._domainkey.acme.com v=DKIM1; t=s; h=sha256; p=… (Ihr Schlüssel)
    TXT emailit.acme.com v=spf1 include:_spf.emailit.com ~all
    MX emailit.acme.com, Priorität 10 feedback-smtp.ffdc-1.emailit.com

    Wenn Ihr DNS bei Cloudflare liegt, können Sie die Einträge stattdessen mit einem Klick anlegen. Siehe Cloudflare.

  3. DNS prüfen. Wählen Sie Check DNS. Wenn SPF, DKIM und Return Path OK anzeigen, ist die Domain Verified. Die meisten Anbieter veröffentlichen Einträge innerhalb von Minuten, es kann aber bis zu 48 Stunden dauern.

Bei Pay as you go zeigt eine Domain, die vor weniger als 30 Tagen registriert wurde, Pending verification, bis das Emailit-Team sie geprüft hat. Details und optionale Einträge für DMARC, Tracking und eingehende E-Mails finden Sie unter Versanddomain hinzufügen.

API-Schlüssel erstellen

  1. API Keys öffnen. Öffnen Sie Email APIAPI Keys und wählen Sie Add API key.

  2. Schlüssel benennen und Scope wählen. Geben Sie einen Namen wie Quickstart ein. Sending Only kann nur E-Mails senden. Full Access kann zusätzlich den Rest der API aufrufen. Für diesen Schnellstart funktioniert beides.

  3. Schlüssel kopieren. Wählen Sie Create und kopieren Sie den Schlüssel. Er beginnt mit secret_ und wird nur einmal angezeigt.

  4. Speichern Sie ihn in einer Umgebungsvariablen, damit er nicht in Ihrem Code landet:

    Terminal
    export EMAILIT_API_KEY="secret_••••"

E-Mail senden

Installieren Sie das SDK für Ihre Sprache oder verwenden Sie cURL:

Terminal
# cURL is preinstalled on macOS, Linux and Windows 10 or later
curl --version

Senden Sie dann eine E-Mail. Verwenden Sie eine Absenderadresse auf der verifizierten Domain und senden Sie an die E-Mail-Adresse, mit der Sie sich registriert haben:

Terminal
curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Hello from Emailit",
    "html": "<p>This is my first email sent with Emailit.</p>"
  }'

Antwort lesen

Eine erfolgreiche Anfrage gibt 200 mit der neuen E-Mail zurück:

JSON
{
  "object": "email",
  "id": "em_2pX7cN4kQ9vLm3RtB8yWd1Zs",
  "token": "2pX7cN4m8FqT1vKz6RbL3HwYd",
  "message_id": "<2pX7cN4m8FqT1vKz6RbL3HwYd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Hello from Emailit",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418Z",
  "tracking": { "loads": false, "clicks": false }
}
Feld Bedeutung
id Die ID der E-Mail. Damit rufen Sie die E-Mail ab, stornieren sie oder senden sie erneut und ordnen Webhook-Events zu.
status accepted bedeutet, dass Emailit die E-Mail zur Zustellung in die Warteschlange gestellt hat. Wenn Sie scheduled_at gesetzt haben, ist er scheduled.
message_id Der Header Message-ID der E-Mail.
ids Nur bei mehreren Empfängern vorhanden. Ordnet jeder Empfängeradresse ihre eigene E-Mail-ID zu.
tracking Ob Öffnungen (loads) und Klicks für diese E-Mail erfasst werden. Tracking erfordert eine verifizierte Tracking-Subdomain.

accepted heißt noch nicht, dass die E-Mail zugestellt ist. Die Zustellung erfolgt im Hintergrund, und der Status ändert sich mit ihrem Fortschritt.

In der Weboberfläche prüfen

Öffnen Sie Email APIEmails. Ihre E-Mail steht oben im Tab Outgoing. Innerhalb weniger Sekunden wechselt ihr Status meist von accepted zu delivered. Öffnen Sie sie, um die Header, den Inhalt, jeden Zustellversuch mit der Antwort des Empfangsservers und die Ergebnisse der Spam-Prüfung zu sehen.

Die Anfrage selbst erscheint unter Email APILogs, mit dem Statuscode sowie dem Anfrage- und Antwort-Body.

Fehlerbehebung

Antwort Ursache Lösung
401 API key required oder Invalid API key Der Header Authorization fehlt oder der Schlüssel ist falsch Senden Sie Authorization: Bearer secret_… mit einem aktuellen Schlüssel
403 unverified_workspace_recipient Der Workspace ist im Sandbox-Modus Senden Sie an die Konto-E-Mail-Adresse eines Workspace-Mitglieds oder beantragen Sie Produktionszugang
422 From/Sender domain is not valid or not verified Die Absenderdomain ist in diesem Workspace nicht verifiziert Verifizieren Sie die Domain oder verwenden Sie eine Adresse auf einer verifizierten Domain
403 Domain not authorized Der reine Sende-Schlüssel ist auf eine andere Domain beschränkt Verwenden Sie einen Schlüssel für diese Domain oder einen unbeschränkten Schlüssel
402 Insufficient credits Der Workspace hat nicht genug Credits Credits hinzufügen
429 Rate limit exceeded Zu viele E-Mails in dieser Sekunde oder heute Warten Sie die Zeit in retry-after ab. Siehe Rate Limits.

Nächste Schritte

Events zu Zustellungen, Bounces und Öffnungen in Echtzeit erhalten.
Einmal in der Weboberfläche gestalten und per Alias mit Variablen senden.
Anfragen sicher wiederholen, ohne doppelt zu senden.
Was Sie prüfen sollten, bevor Sie an echte Empfänger senden.

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.