E-Mail mit Anhang automatisch versenden
Diese Funktion versendet eine E-Mail mit einer beigefügten Datei – etwa einer Rechnung, einem Bericht oder einem Bild – in einem einzigen Aufruf. Sie übergeben Empfänger, Text und die Datei selbst, KIT stellt beides gemeinsam zu, ohne separaten Upload-Schritt für den Anhang.
Nachricht und Datei in einem Schritt
Ein Anhang bedeutet normalerweise zwei Arbeitsschritte: die Datei irgendwo bereitstellen und in der Nachricht darauf verweisen, oder sie technisch an die Mail anhängen. Diese Funktion nimmt Empfänger, Text und Datei gemeinsam entgegen und stellt beides als eine E-Mail mit Anhang zu – etwa eine automatisch erzeugte Rechnung direkt nach dem Verkaufsabschluss. Für mehrere Anhänge in einer einzigen Nachricht lassen sich mehrere Dateien in derselben Anfrage übergeben.
Welche Dateien sich eignen
PDF-Dateien, Bilder oder einfache Dokumente lassen sich als Anhang mitschicken, etwa eine mit einer anderen KIT-Funktion erzeugte Rechnung oder ein Screenshot. Für sehr große Dateien ist die E-Mail selbst kein geeigneter Transportweg – die meisten Mailserver weisen Anhänge oberhalb weniger Megabyte grundsätzlich ab, unabhängig vom Versandweg. In solchen Fällen ist ein Link zum Download die verlässlichere Wahl. Ein Test mit einer einzelnen Beispieldatei zeigt vorab, ob Format und Größe zuverlässig ankommen.
Was das kostet
Der Versand mit Anhang kostet wie die einfache Nachricht $0.002 pro Anfrage plus $0.0035 pro E-Mail, in Summe $0.0055 – die Größe des Anhangs verändert diesen Preis nicht zusätzlich. Ausgeführt wird die Funktion direkt auf dieser Seite für einen einzelnen Versand oder über die API, wenn der Anhang automatisiert aus einer anderen Funktion entsteht, etwa einer erzeugten Rechnung. Bereits bei der ersten Ausführung sehen Sie den tatsächlichen Preis für die konkrete Datei.
Anwendungsfälle
Rechnung direkt nach der Erstellung versenden
Weber Metallbau GmbH erzeugt die Rechnung als PDF und verschickt sie im selben Arbeitsschritt an die Kundschaft, ohne die Datei zwischenzuspeichern.
Bericht an die Geschäftsleitung
Ein Unternehmen aus Hamburg verschickt den wöchentlichen Auswertungsbericht als PDF-Anhang automatisch an die Geschäftsleitung, jeden Montagmorgen.
Nachweis an eine Behörde
Sabine Schneider sendet ein angefordertes Dokument als Anhang direkt aus ihrer Verwaltungssoftware, ohne es vorher manuell herunterzuladen und neu anzuhängen.
Häufige Fragen
Wie groß darf der Anhang sein?
Es ist aktuell kein festes Limit veröffentlicht; da die meisten Mailserver Anhänge oberhalb weniger Megabyte ohnehin ablehnen, eignen sich vor allem kompakte Dokumente wie Rechnungen oder Berichte.
Kostet ein Anhang zusätzlich zum Versand?
Nein, der Preis bleibt $0.0055 je zugestellter Nachricht, unabhängig von der Größe des Anhangs innerhalb der üblichen Mailserver-Grenzen.
Welche Dateiformate kann ich anhängen?
Gängige Formate wie PDF und Bilder lassen sich anhängen; für sehr unübliche Formate empfiehlt sich vorher ein Test mit einer einzelnen Nachricht.
Was passiert mit der angehängten Datei nach dem Versand?
Sie wird ausschließlich zur Zustellung verwendet und danach nicht weiter gespeichert.
Kann ich den Anhang automatisch aus einer anderen KIT-Funktion übernehmen?
Ja, ein zuvor erzeugtes Dokument lässt sich über die API direkt als Anhang weitergeben, ohne Umweg über einen manuellen Download.
Ist für den Versand mit Anhang ein Konto notwendig?
Nein, auch hier zahlen Sie pro versendeter Nachricht, ohne Konto und ohne Abonnement.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/notify/email-attachment \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/notify/email-attachment", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/notify/email-attachment",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/notify/email-attachment", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/email-attachment", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"input": "…"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "notify.email_attachment",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |