---
title: SMTP-Relay
description: "Das BillionSend-SMTP-Relay mit jedem SMTP-Client oder Framework-Mailer nutzen: Host, Ports, TLS, Limits, Ratenlimits und alle Antwortcodes."
ai:
  exclude: true
---

Das SMTP-Relay nimmt E-Mails von jedem SMTP-Client oder Framework-Mailer entgegen und sendet sie wie `POST /emails`: mit denselben Absenderprüfungen, Sperrlisten, Tariflimits und Events.

## Verbinden

| Einstellung | Wert |
| --- | --- |
| Host | `smtp.billionsend.com` |
| Port, STARTTLS | `587` |
| Port, implizites TLS | `465` |
| Benutzername | `billionsend` |
| Passwort | Ein [API-Schlüssel](/docs/de/api-reference/basics) (`bs_...`), zum Beispiel ein SMTP-Zugang von der Seite **SMTP** (siehe [API-Schlüssel](/docs/de/api-keys)) |

TLS ist auf beiden Ports Pflicht. Ein Schlüssel, der nur zum Senden dient oder auf eine Domain oder ein Postfach beschränkt ist, behält diese Beschränkungen auch über SMTP.

```bash
curl --ssl-reqd smtp://smtp.billionsend.com:587 \
  --user "billionsend:$BILLIONSEND_API_KEY" \
  --mail-from hello@mail.example.com \
  --mail-rcpt success@simulator.amazonses.com \
  -T message.eml
```

## Was das Relay prüft

- Die `From`-Adresse muss zu einer [verifizierten Domain](/docs/de/concepts/domains) des Teams des Schlüssels gehören.
- Ein nicht leerer `Subject` und ein HTML- oder Textkörper sind Pflicht.
- Eine Nachricht darf bis zu 40 MiB groß sein und bis zu 50 Empfänger haben.
- Für Anhänge gelten dieselben Regeln wie in der API: Programme und getarnte Dateitypen werden abgelehnt.
- Für Header gilt dieselbe Allowlist wie bei `POST /emails` (`X-*`-Namen, Threading, Priorität, `List-Unsubscribe`). Alle anderen Header schreibt BillionSend selbst.
- Drei fehlgeschlagene Anmeldungen beenden die Verbindung. Eine Sitzung dauert höchstens 15 Minuten, und eine IP-Adresse kann höchstens 10 Verbindungen halten.

## Ratenlimits und Wiederholungen

E-Mails zählen auf dasselbe Limit pro Minute wie die API-Anfragen des Schlüssels. Darüber antwortet das Relay mit `451 4.7.1` und der Wartezeit in Sekunden. SMTP-Clients wiederholen das von selbst.

Wenn ein Client das abschließende `250` nie gesehen hat und dieselbe Nachricht mit derselben `Message-ID` erneut sendet, erhält er die erste Antwort zurück statt einer zweiten E-Mail.

## Fehler

| Antwort | Bedeutung |
| --- | --- |
| `530` / `535` | Fehlende oder falsche Zugangsdaten |
| `550` | Absender für diesen Schlüssel nicht erlaubt, ein Empfänger, der keine E-Mails empfangen kann, alle Empfänger gesperrt oder ein gesperrtes Team |
| `552` | Nachricht oder Anhang zu groß |
| `553` | Fehlender Betreff oder fehlerhafte Adresse |
| `554` | Nachricht abgelehnt, zum Beispiel wegen einer nicht verifizierten Absenderdomain oder eines nicht erlaubten Headers |
| `451` | Vorübergehend: Limit pro Minute überschritten (`4.7.1`, mit der Wartezeit in Sekunden) oder Versand pausiert, bis sich Ihre Raten erholen. Wiederholen. |
| `452` | Mehr als 50 Empfänger (den Rest in einer weiteren Nachricht senden) oder ein Kontingent ist aufgebraucht: Der Tagesstau ist voll, das Monatsvolumen ist verbraucht (es wird mit der Verlängerung des Zeitraums frei), der Stau der Aufwärmphase einer neuen Domain ist voll oder das tägliche Sendelimit des Postfachs ist erreicht |
