Hilfe › Für Entwickler

Sending API

Senden Sie E-Mails aus Ihren eigenen Apps und Websites, von Ihren eigenen Adressen, mit Ihren eigenen Vorlagen.

Ihre Apps, Websites und Skripte können mit einer HTTPS-Anfrage E-Mails von den Adressen Ihrer Organisation senden: Bestellbestätigungen, Passwort-Zurücksetzungen, Kontaktformulare, Berichte. Die E-Mails gehen genauso hinaus wie die, die Sie in SendHaste schreiben.

AnfrageWas es tut
POST https://sendhaste.com/api/v1/emailsSendet eine E-Mail: Ihren eigenen Inhalt oder eine Ihrer Vorlagen mit Werten.
GET https://sendhaste.com/api/v1/templatesListet die mit Vorlagen verbundenen E-Mails und die Werte, die jede verwendet.
GET https://sendhaste.com/api/v1/sendersListet die Adressen auf, von denen der Schlüssel senden darf.
GET https://sendhaste.com/api/v1/openapi.jsonDie ganze API als OpenAPI-3.1-Datei, für Postman, Codegeneratoren und andere Entwicklerwerkzeuge. Kein Schlüssel nötig.

1. API-Schlüssel erstellen

  1. Ein Org-Super-Admin öffnet Einstellungen → API-Schlüssel.
  2. Klicken Sie auf API-Schlüssel erstellen, geben Sie ihm einen Namen (z. B. Kontaktformular der Website) und wählen Sie Sendet von: jede Adresse auf Ihren Domains, jede Adresse auf einer Domain oder nur eine Adresse. Klicken Sie auf Schlüssel erstellen.
  3. Ein Fenster zeigt den neuen Schlüssel mit seinem Namen und der Adresse, von der er sendet. Klicken Sie auf Kopieren und dann auf Fertig. Der Schlüssel beginnt mit sh_ und wird nur einmal angezeigt: Geht er verloren, widerrufen Sie ihn und erstellen Sie einen neuen.

Für automatische E-Mails von einer Domain (Bestellbestätigungen, Warnungen, Berichte) öffnen Sie Einstellungen → Domains, wählen die Domain und klicken auf API-Schlüssel für yourdomain.com erstellen: Der Schlüssel darf von jeder Adresse auf dieser Domain senden und von keiner anderen. Legen Sie zuerst ein Postfach für die Absenderadresse an, etwa noreply@yourdomain.com. Nur der Absender ist beschränkt: Die E-Mails können an jeden gehen, in Ihrem Unternehmen oder außerhalb.

Bewahren Sie den Schlüssel auf Ihrem Server auf, in einer Einstellung oder Umgebungsvariable. Legen Sie ihn nie in eine Webseite, eine mobile App oder ein öffentliches Code-Repository: Wer ihn hat, kann in Ihrem Namen E-Mails senden. Wird er bekannt, klicken Sie auf Widerrufen: Er funktioniert sofort nicht mehr.

2. E-Mail senden

Senden Sie eine POST-Anfrage an https://sendhaste.com/api/v1/emails, mit dem Schlüssel im Authorization: Bearer sh_…-Header und der E-Mail als JSON:

curl
curl https://sendhaste.com/api/v1/emails \
  -H "Authorization: Bearer sh_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Your Company <info@yourcompany.com>",
    "to": ["client@example.com"],
    "subject": "Your booking is confirmed",
    "html": "<p>Thank you! See you on <b>Monday</b>.</p>",
    "text": "Thank you! See you on Monday."
  }'
JavaScript (Node.js 18+)
const res = await fetch("https://sendhaste.com/api/v1/emails", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.SENDHASTE_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    from: "Your Company <info@yourcompany.com>",
    to: "client@example.com",
    subject: "Your booking is confirmed",
    text: "Thank you! See you on Monday.",
  }),
});
const result = await res.json(); // { id, from, to, recipients } or { error: { code, message } }

3. Eigene Vorlagen senden

Statt die E-Mail im Code zu schreiben, gestalten Sie sie einmal unter Vorlagen und lassen Ihre Website sie per Namen senden: eine Willkommens-E-Mail, ein Passwort-Reset, eine Bestellbestätigung. Um die E-Mail später zu ändern, bearbeiten Sie die Vorlage oder verbinden den Namen mit einer anderen; an der Website ändert sich nichts.

  1. Gestalten Sie die E-Mail unter Vorlagen. Wo ein Wert von Ihrer Website stehen soll, schreiben Sie {{params.first_name}}; nach einem Strich, was bei fehlendem Wert gilt: {{params.first_name|there}}. Das funktioniert im Betreff, im Text und in Button- und Link-Adressen.
  2. Ein Org Super Admin öffnet Einstellungen → API-Schlüssel, klickt unter E-Mails Ihrer Websites auf E-Mail verbinden, gibt einen E-Mail-Namen ein (z. B. welcome), wählt die Vorlage, wählt unter Gesendet von alle Adressen Ihrer Domains, eine Domain oder eine Adresse und klickt auf Verbinden.
  3. Senden Sie sie unter Test senden mit einigen Werten an sich selbst, um zu sehen, wie sie aussieht.
  4. Ihre Website sendet template mit dem Namen und params mit den Werten. Der Betreff der Vorlage gilt, außer Sie senden ein subject.
curl
curl https://sendhaste.com/api/v1/emails \
  -H "Authorization: Bearer sh_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Your Shop <hello@yourshop.com>",
    "to": "aysel@example.com",
    "template": "welcome",
    "params": { "first_name": "Aysel", "verify_url": "https://yourshop.com/verify?t=8f2c" }
  }'
  • Die eingebauten Tags funktionieren auch: {{first_name}}, {{name}}, {{company}}, {{email}}. {{email}} ist die erste An-Adresse; die Namen kommen aus params, wenn Sie sie senden, sonst aus dem Kontakt der Person in SendHaste.
  • Werte werden als Text eingesetzt: HTML in einem Wert erscheint wie geschrieben, und ein Link-Wert muss mit https://, http:// oder mailto: beginnen.
  • Ein Wert ohne Ersatz bleibt leer – testen Sie also zuerst mit Test senden.

Beispiel: eine Willkommens-E-Mail für neue Anmeldungen

  1. Erstellen Sie eine Vorlage namens Welcome mit dem Betreff Welcome, {{params.first_name|there}}!, einer Überschrift Hi {{params.first_name|there}} und einem Button zu {{params.verify_url}}.
  2. Verbinden Sie sie als welcome unter Einstellungen → API-Schlüssel und erstellen Sie einen Schlüssel, der von Ihrer Adresse sendet.
  3. Legen Sie den Schlüssel in den Einstellungen Ihrer Website ab (zum Beispiel in einer Umgebungsvariable SENDHASTE_API_KEY).
  4. Wo Ihre Website einen neuen Nutzer speichert, senden Sie die Anfrage. Wählen Sie Ihre Sprache:
JavaScript (Node.js 18+)
await fetch("https://sendhaste.com/api/v1/emails", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.SENDHASTE_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    from: "Your Shop <hello@yourshop.com>",
    to: user.email,
    template: "welcome",
    params: { first_name: user.firstName, verify_url: verifyUrl },
  }),
});
PHP
$ch = curl_init("https://sendhaste.com/api/v1/emails");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SENDHASTE_API_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode([
    "from" => "Your Shop <hello@yourshop.com>",
    "to" => $user["email"],
    "template" => "welcome",
    "params" => ["first_name" => $user["first_name"], "verify_url" => $verifyUrl],
  ]),
]);
$result = json_decode(curl_exec($ch), true);
Python
import os, requests

requests.post(
    "https://sendhaste.com/api/v1/emails",
    headers={"Authorization": f"Bearer {os.environ['SENDHASTE_API_KEY']}"},
    json={
        "from": "Your Shop <hello@yourshop.com>",
        "to": user.email,
        "template": "welcome",
        "params": {"first_name": user.first_name, "verify_url": verify_url},
    },
    timeout=10,
)

Senden Sie sie, nachdem der Nutzer gespeichert ist, und lassen Sie eine fehlgeschlagene E-Mail die Anmeldung nicht aufhalten: Fehler protokollieren und weitermachen. Die id aus der Antwort hilft uns, eine E-Mail zu finden, wenn Sie uns schreiben.

Ihre Vorlagen auflisten

GET https://sendhaste.com/api/v1/templates mit demselben Schlüssel liefert die unter Einstellungen → API-Schlüssel verbundenen E-Mails und die Werte, die jede verwendet:

JSON
{"data": [{"name": "welcome", "template_name": "Welcome", "subject": "Welcome, {{params.first_name|there}}!", "params": ["first_name", "verify_url"], "updated_at": "…", "scope": "domain", "for": "yourshop.com"}]}
FeldWas es ist
nameWas als template gesendet wird.
template_nameDer Name der Vorlage in SendHaste.
subjectDer Betreff der Vorlage, Tags noch nicht ausgefüllt.
paramsDie {{params.…}}-Namen, die die Vorlage verwendet: senden Sie diese in params.
updated_atWann die Vorlage zuletzt geändert wurde.
scopeFür wen sie verbunden ist: organization (alle Adressen Ihrer Domains), domain oder address.
forDie Domain oder die Adresse, für die sie verbunden ist; null für die ganze Organisation.

Ihr Code kann dies beim Start oder in einem Test aufrufen, um zu prüfen, dass jede gesendete E-Mail verbunden ist und alle ihre Werte bekommt.

Jede E-Mail wird für alle Adressen Ihrer Domains, für eine Domain oder für eine Adresse verbunden (Gesendet von). Ein Schlüssel listet und sendet nur die E-Mails für die Adressen, von denen er senden darf; Websites auf verschiedenen Domains sehen also jeweils ihre eigenen. Derselbe Name kann auf jeder Ebene verbunden werden: Eine E-Mail von info@yourshop.com nutzt die für diese Adresse, sonst die für ihre Domain, sonst die der Organisation.

Ihre Adressen auflisten

GET https://sendhaste.com/api/v1/senders mit demselben Schlüssel liefert die Adressen, von denen er senden darf. Damit lässt sich die Absenderadresse auswählen, statt sie in den Code zu schreiben.

JSON
{"data": [{"address": "info@yourcompany.com"}, {"address": "noreply@yourcompany.com"}], "domains": [{"domain": "yourcompany.com"}]}
FeldWas es ist
dataAlle Adressen mit Postfach, von denen der Schlüssel senden darf: die eine Adresse, für die er erstellt wurde, alle Postfächer seiner Domain oder alle Postfächer Ihrer Domains.
domainsDie Domains, von denen der Schlüssel senden darf. Leer bei einem Schlüssel für eine einzelne Adresse.

Jede Absenderadresse braucht ein eigenes Postfach in SendHaste. Eine Adresse, die einem Postfach unter Empfängt auch hinzugefügt wurde, geht nicht, catchall@ ebenso wenig. Für eine reine Sendeadresse wie noreply@yourdomain.com legen Sie unter Einstellungen → Domains ein Postfach dafür an; sie erscheint sofort in data.

Die Felder

FeldErforderlichWas es ist
fromjaEine Ihrer Adressen, auf Wunsch mit Namen: Your Company <info@yourcompany.com>. Sie muss ein Postfach in SendHaste haben.
tojaEine Adresse oder eine Liste von Adressen.
cc, bccneinEine Adresse oder eine Liste. Bcc-Empfänger werden den anderen nicht angezeigt.
reply_toneinWohin Antworten gehen, wenn nicht an die From-Adresse.
subjectja, außer bei templateDie Betreffzeile. Mit einer Vorlage ersetzt sie deren Betreff.
texttext oder htmlDie Nur-Text-Version.
htmltext oder htmlDie HTML-Version. Senden Sie wenn möglich beide; bei nur HTML wird die Textversion daraus erstellt.
attachmentsneinEine Liste von Dateien: filename, content, content_type. Der Inhalt ist base64-kodiert.
templateneinDer Name einer unter Einstellungen → API-Schlüssel verbundenen E-Mail, z. B. welcome. Statt text und html.
paramsneinMit einer Vorlage: die Werte für ihre {{params.…}}-Tags, z. B. {"first_name": "Aysel"}. Bis zu 100 Werte.

Die Antwort

Wenn die E-Mail gesendet ist: Status 200 und {"id": "…", "from": "info@yourcompany.com", "to": ["client@example.com"], "recipients": 1, "status": "sent"}. Mit einer Vorlage auch "template": "welcome".

Wenn das heutige Tageslimit aufgebraucht ist, das von morgen aber noch Platz hat: Status 202 und dieselben Felder, dazu "status": "queued", "deliverAfter": "2026-10-13T00:00:00Z". Die E-Mail ist angenommen und SendHaste behält sie; sie geht um deliverAfter hinaus (die nächste Mitternacht UTC) oder danach, sobald der Mailserver sie annimmt. Behandeln Sie 202 als Erfolg und senden Sie sie nicht erneut: Ein zweiter Versuch würde sie doppelt zustellen.

Wenn nicht: ein Fehlerstatus und {"error": {"code": "…", "message": "…"}}. Der code bleibt gleich, sodass Ihr Code ihn prüfen kann; die Meldung sagt, was zu korrigieren ist.

StatuscodeWas zu tun ist
401missing_api_key, invalid_api_keyPrüfen Sie den Authorization-Header oder erstellen Sie einen neuen Schlüssel: Dieser wurde widerrufen.
403from_not_allowedSenden Sie von einer Adresse auf Ihren Domains (nicht catchall@, das nur empfängt) oder von der Domain bzw. der einen Adresse, auf die der Schlüssel beschränkt ist.
403api_disabledDas Senden über die API ist für Ihre Organisation nicht eingeschaltet: Fragen Sie uns über die Support-Seite.
400invalid_jsonSenden Sie ein JSON-Objekt.
415unsupported_media_typeSetzen Sie Content-Type: application/json.
422invalid_field, mailbox_not_foundKorrigieren Sie das in der Meldung genannte Feld oder legen Sie zuerst das From-Postfach an.
404template_not_foundVerbinden Sie den E-Mail-Namen unter Einstellungen → API-Schlüssel mit einer Vorlage, für die From-Adresse, ihre Domain oder die ganze Organisation, oder prüfen Sie die Schreibweise.
413too_largeSenden Sie kleinere Anhänge.
429rate_limited, daily_limitZu viele Anfragen: Warten Sie die Sekunden aus dem Retry-After-Header ab. Tageslimit: Die E-Mails für heute und morgen sind beide aufgebraucht, oder das Tageslimit des Mailservers für die Adresse ist erreicht; warten Sie die Sekunden aus Retry-After ab (bis Mitternacht UTC) und senden Sie dann.
502, 503send_failed, mailbox_not_readyNicht gesendet: Versuchen Sie es in ein paar Minuten erneut. Wenn es so bleibt, schreiben Sie uns. Eine E-Mail, die der Mailserver angenommen hat, bekommt diese Antwort nie, auch wenn seine Antwort lange dauerte.

Limits

  • Bis zu 60 Anfragen pro Minute und Schlüssel.
  • Bis zu 50 Empfänger pro E-Mail (to, cc und bcc zusammen).
  • Bis zu 20 Anhänge und 25 MB pro E-Mail.
  • Jede Domain kann bis zu 300 E-Mails am Tag senden, ob aus SendHaste oder über die API, und jedes ihrer Postfächer kann so vielen Personen schreiben, wie das Limit der Domain erlaubt, oder weniger, wenn ein Org-Super-Admin auf der Seite der Domain Personen, die jedes Postfach pro Tag anschreiben darf festlegt. Eine neu verbundene Domain startet niedriger; ihre Seite unter Einstellungen → Domains zeigt E-Mails heute gegenüber ihrem Limit, Heute abgelehnt, Für morgen zurückgehalten und Aufwärmphase, solange es steigt.
  • Eine E-Mail über dem heutigen Limit geht nicht verloren: SendHaste behält sie und sendet sie nach Mitternacht UTC, angerechnet auf morgen (Status 202). Ist der Mailserver dann noch an seinem eigenen Limit, geht sie hinaus, sobald der Server sie annimmt. Erst wenn auch das Limit von morgen aufgebraucht ist, wird sie abgelehnt (daily_limit).
  • So wartende E-Mails stehen in der Seitenleiste des Postfachs unter Geplant, im Abschnitt Vom Tageslimit für den Versand zurückgehalten; Sie müssen nichts tun, sie gehen von selbst hinaus.

Lieber SMTP? Viele Apps und Frameworks können stattdessen per SMTP über ein Postfach senden: Server und Port finden Sie unter Outlook, Apple Mail und Apps auf dem Telefon. Es gelten dieselben Tageslimits.

Nicht gefunden, was Sie suchen? Schreiben Sie uns.