E-Mail-API

Die E-Mail-API sendet E-Mails aus Ihrer Anwendung per HTTPS statt über eine SMTP-Verbindung. Nutzen Sie sie für transaktionale E-Mails wie Registrierungsbestätigungen, Passwort-Resets, Belege und Benachrichtigungen, besonders wenn Sie Vorlagen, Planung, idempotente Wiederholungen und eine eigene ID für jeden Empfänger möchten.

So funktioniert es

1. Ihre Anwendung ruft POST /emails mit einer Absenderadresse auf einer verifizierten VersanddomainVersanddomainEine Domain, die Ihnen gehört und die Sie mit DNS-Einträgen verifizieren, damit Emailit mit SPF, DKIM und eigenem Return-Path E-Mails von ihr senden kann., den Empfängern und dem Inhalt oder einer Vorlage auf.
2. Emailit validiert die Anfrage, berechnet 1 Credit pro Empfänger und erstellt pro Empfänger eine E-Mail mit eigener em_-ID.
3. Die Antwort kommt sofort mit dem Status accepted zurück, oder scheduled, wenn Sie einen Sendezeitpunkt festgelegt haben. Die Zustellung läuft im Hintergrund.
4. Emailit signiert die Nachricht per DKIM für Ihre Domain, führt Spam-Prüfungen aus und stellt sie zu. Vorübergehende Fehler werden etwa 21 Stunden lang erneut versucht.
5. Jede Statusänderung erscheint unter Email API›Emails und wird an Ihre Webhooks gesendet.

Basis-URL und Authentifizierung

Ein Schlüssel mit Full Access kann jeden Endpunkt aufrufen. Ein Schlüssel mit Sending Only kann E-Mails senden, verschieben, stornieren, erneut senden und weiterleiten, und Sie können ihn auf eine einzelne Versanddomain beschränken. Details finden Sie unter Authentifizierung.

E-Mail senden

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": "Welcome to Acme",
    "html": "<p>Thanks for signing up, Ada.</p>",
    "text": "Thanks for signing up, Ada."
  }'

import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

const email = await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up, Ada.</p>',
  text: 'Thanks for signing up, Ada.',
});

console.log(email.id);

import os
from emailit import EmailitClient

client = EmailitClient(os.environ["EMAILIT_API_KEY"])

email = client.emails.send({
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up, Ada.</p>",
    "text": "Thanks for signing up, Ada.",
})

$emailit = Emailit::client(getenv('EMAILIT_API_KEY'));

$email = $emailit->emails()->send([
    'from' => 'Acme <hello@acme.com>',
    'to' => 'ada@example.com',
    'subject' => 'Welcome to Acme',
    'html' => '<p>Thanks for signing up, Ada.</p>',
    'text' => 'Thanks for signing up, Ada.',
]);

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

{
  "object": "email",
  "id": "em_33VtK8mRq1xZp7LwN4cY2bHsDfa",
  "token": "33VtK8m4XcPq2RwZ7nLb1YsTgHd",
  "message_id": "<33VtK8m4XcPq2RwZ7nLb1YsTgHd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Welcome to Acme",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418203Z",
  "tracking": { "loads": false, "clicks": false }
}

Neue Workspaces beginnen im Sandbox-Modus und können nur an die Kontoadressen von Mitgliedern des Workspace senden. Beantragen Sie Produktionszugang, bevor Sie an andere Empfänger senden.

Was Sie tun können

Limits

Rate Limits zählen Empfänger, daher verbraucht eine Anfrage an 10 Empfänger 10 Einheiten Ihres Kontingents pro Sekunde und pro Tag. 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. Siehe Limits und Rate Limits.

Credits

Jeder Empfänger kostet 1 Credit, und Adressen in to, cc und bcc zählen alle. Hat der Workspace nicht genug Credits für alle Empfänger, schlägt die Anfrage mit 402 fehl, und nichts wird gesendet. Erneutes Senden und Weiterleitungen werden wie neue Versände berechnet.

Wie inklusive und gekaufte Credits verbraucht werden, erfahren Sie unter Credits.

Nächste Schritte