# E-Mail-API

> Senden Sie transaktionale E-Mails mit einer einzigen HTTPS-Anfrage und planen, stornieren, wiederholen oder leiten Sie sie anschließend weiter. Basis-URL, Authentifizierung, Funktionen und Limits.

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 Versanddomain, 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](/de/docs/webhooks/) gesendet.

## Basis-URL und Authentifizierung

| Element | Wert |
| --- | --- |
| Basis-URL | `https://api.emailit.com/v2` |
| Authentifizierung | `Authorization: Bearer secret_••••` mit einem [API-Schlüssel](/de/docs/developers/api-keys/) |
| Anfrage-Body | JSON, gesendet mit `Content-Type: application/json` |
| Sende-Endpunkt | `POST /emails` |

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](/de/docs/api-reference/authentication/).

## E-Mail senden

**cURL**

```bash
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."
  }'
```

**Node.js**

```javascript
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);
```

**Python**

```python
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.",
})
```

**PHP**

```php
$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:

```json
{
  "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](/de/docs/workspaces/production-access/), bevor Sie an andere Empfänger senden.

## Was Sie tun können

  - [E-Mail senden](/de/docs/email-api/send-email/): Absenderadressen, Empfänger, Inhalt, Vorlagen, Tracking und alle Fehler.
  - [Anhänge](/de/docs/email-api/attachments/): Dateien als Base64 oder über eine URL anhängen und Bilder einbetten.
  - [Planung](/de/docs/email-api/scheduling/): Später senden, verschieben oder eine E-Mail stornieren, bevor sie hinausgeht.
  - [Idempotenz](/de/docs/email-api/idempotency/): Anfragen sicher wiederholen, ohne dieselbe E-Mail zweimal zu senden.
  - [Header und Metadaten](/de/docs/email-api/headers-and-metadata/): Eigene Header, List-Unsubscribe und Metadaten, die in Webhooks zurückkommen.
  - [Erneut senden und weiterleiten](/de/docs/email-api/retry-and-forward/): Fehlgeschlagene oder zurückgehaltene E-Mails erneut senden oder eine gesendete E-Mail an jemand anderen weiterleiten.
  - [Vorlagen](/de/docs/templates/): Designs einmal speichern und per Alias mit Temple-Variablen senden.
  - [API-Referenz für E-Mails](/de/docs/api-reference/emails/): Alle E-Mail-Endpunkte mit Parametern und Antworten.

## Limits

| Limit | Wert |
| --- | --- |
| Empfänger pro Anfrage | 50 in `to`, 50 in `cc` und 50 in `bcc` |
| Nachrichtengröße | 40 MB, einschließlich kodierter Anhänge |
| Von einer URL heruntergeladener Anhang | 25 MB, mit einem Download-Timeout von 30 Sekunden |
| Idempotenzfenster | 24 Stunden |
| Senderate (Standard) | 2 E-Mails pro Sekunde und 5.000 E-Mails pro Tag pro Workspace, gemeinsam mit SMTP |
| Weiterleitung | 3 Weiterleitungen pro Stunde pro Workspace |
| Geplante E-Mail verschieben oder stornieren | Bis 3 Minuten vor ihrem Sendezeitpunkt |
| Zeitfenster für erneutes Senden | 30 Tage nach Erstellung der ursprünglichen E-Mail |

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](/de/docs/limits/) und [Rate Limits](/de/docs/api-reference/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.

| 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 |

Wie inklusive und gekaufte Credits verbraucht werden, erfahren Sie unter [Credits](/de/docs/billing/credits/).

## Nächste Schritte

  - [API-Schnellstart](/de/docs/quickstart/api/): Senden Sie Ihre erste E-Mail in wenigen Minuten.
  - [Versanddomain hinzufügen](/de/docs/domains/add-a-domain/): Die Domain verifizieren, von der Sie senden.
  - [Webhook einrichten](/de/docs/webhooks/set-up/): Events zu Zustellungen, Bounces und Engagement erhalten.
  - [API oder SMTP?](/de/docs/get-started/api-or-smtp/): E-Mail-API und SMTP-Relay im Vergleich.

---
Quelle: https://emailit.com/de/docs/email-api/