API

Brief- und Post-API: Briefe in Deutschland und ins Ausland versenden

Mit unserer Brief- und Post-API übermitteln Sie PDFs direkt aus Ihrer Software. briefsenden.com übernimmt Druck, Kuvertierung und Einlieferung bei der Deutschen Post für die Zustellung in Deutschland und ins Ausland. Den Bearbeitungsstatus erhalten Sie per API oder Webhook zurück in Ihr System. Mit einem Test-Key testen Sie ohne Druck und Versand.

API-Dokumentation Kostenlos registrieren und Test-Key erstellen

Brief per REST-API versenden

Vom Konto bis zum ersten API-Brief – in vier einfachen Schritten

E-Mail-Adresse

Passwort

Konto erstellen

Registrieren Sie sich kostenlos und bestätigen Sie Ihre E-Mail-Adresse. Mit einem Test-Key testen Sie danach ohne Druck und ohne Kosten.

Einstellungen → Entwickler

Testbv_test_••••3f9a

Livebv_live_••••c21e

API-Key erstellen

API-Key generieren

Erstellen Sie unter Einstellungen → Entwickler einen API-Key. Nutzen Sie einen Test-Key (bv_test_*) für die Entwicklung oder einen Live-Key (bv_live_*) für den Produktivbetrieb.

cURL

POST /api/v1/letters/simple

X-Api-Key: bv_test_••••

file=@rechnung.pdf

recipientLine1=Max Mustermann

recipientZip=12345

recipientCity=Berlin

201Created

Ersten Brief senden

Senden Sie ein PDF mit Empfängeradresse per POST /api/v1/letters/simple. Mit einem Test-Key entstehen keine Kosten und kein physischer Versand.

Webhook

letter.processingIn Bearbeitung
letter.in_printIm Druck
letter.sentVersendet

GET/api/v1/letters/{id}"SENT"

Status abfragen

Fragen Sie den aktuellen Versandstatus per GET /api/v1/letters/{id} ab oder lassen Sie sich per Webhook automatisch benachrichtigen.

Ein Brief in einem Request

Versenden Sie Briefe in Ihrer bevorzugten Programmiersprache. Unsere API akzeptiert multipart/form-data und antwortet mit JSON.

curl -X POST https://www.briefsenden.com/api/v1/letters/simple \
  -H "X-Api-Key: bv_test_xxx" \
  -F "file=@rechnung.pdf" \
  -F "recipientLine1=Max Mustermann" \
  -F "recipientLine2=Musterstraße 1" \
  -F "recipientZip=12345" \
  -F "recipientCity=Berlin" \
  -F "recipientCountry=DE" \
  -F "color=bw" \
  -F "duplex=simplex"

import requests

url = "https://www.briefsenden.com/api/v1/letters/simple"
headers = {"X-Api-Key": "bv_test_xxx"}

files = {"file": open("rechnung.pdf", "rb")}
data = {
    "recipientLine1": "Max Mustermann",
    "recipientLine2": "Musterstraße 1",
    "recipientZip": "12345",
    "recipientCity": "Berlin",
    "recipientCountry": "DE",
    "color": "bw",
    "duplex": "simplex",
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

// Node.js 18+, als ES-Modul (z. B. brief.mjs) – fetch, FormData und Blob sind eingebaut
import fs from "node:fs";

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("rechnung.pdf")], { type: "application/pdf" }), "rechnung.pdf");
form.append("recipientLine1", "Max Mustermann");
form.append("recipientLine2", "Musterstraße 1");
form.append("recipientZip", "12345");
form.append("recipientCity", "Berlin");
form.append("recipientCountry", "DE");
form.append("color", "bw");
form.append("duplex", "simplex");

const response = await fetch("https://www.briefsenden.com/api/v1/letters/simple", {
  method: "POST",
  headers: { "X-Api-Key": "bv_test_xxx" },
  body: form,
});
console.log(await response.json());

$ch = curl_init("https://www.briefsenden.com/api/v1/letters/simple");

$postFields = [
    "file"             => new CURLFile("rechnung.pdf", "application/pdf"),
    "recipientLine1"   => "Max Mustermann",
    "recipientLine2"   => "Musterstraße 1",
    "recipientZip"     => "12345",
    "recipientCity"    => "Berlin",
    "recipientCountry" => "DE",
    "color"            => "bw",
    "duplex"           => "simplex",
];

curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $postFields,
    CURLOPT_HTTPHEADER     => ["X-Api-Key: bv_test_xxx"],
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Ersetzen Sie bv_test_xxx durch Ihren API-Key – mit einem Test-Key entstehen keine Kosten. Die vollständige Dokumentation mit weiteren Beispielen finden Sie auf der API-Dokumentationsseite.

API-Funktionen

Unsere API basiert auf REST-Prinzipien mit vorhersagbaren URLs, JSON-Responses und standardkonformen HTTP-Statuscodes. Alles, was Sie für eine nahtlose Integration brauchen.

RESTful JSON API

Vollständige REST-API mit OpenAPI-Dokumentation und interaktiver Swagger-UI. Standardkonforme JSON-Responses ermöglichen die Integration in jede Programmiersprache und jedes Framework.

Test- & Live-Keys

Separate API-Keys für Entwicklung (bv_test_*) und Produktion (bv_live_*), gesendet im Header X-Api-Key. Testen Sie Ihre Integration risikofrei, bevor Sie in den Produktivbetrieb wechseln.

Webhooks

Echtzeit-Benachrichtigungen bei Statusänderungen Ihrer Briefe. Erhalten Sie automatisch Updates zu Upload, Druck und Versand per HTTP-Callback.

Rate Limiting

Ein Request je 500 ms pro API-Key, mit einer Warteschlange für bis zu 10 weitere Requests. Bei voller Warteschlange antwortet die API mit HTTP 429.

Idempotency-Keys

Für POST-Anfragen speichert die API erfolgreiche Antworten mit Idempotency-Key für 24 Stunden. Wiederholen Sie denselben Auftrag mit demselben Key erst nach Abschluss des ersten Requests.

Swagger-Dokumentation

Interaktive Dokumentation mit Code-Beispielen und Try-it-out-Funktion. Testen Sie Endpoints direkt im Browser, ohne eine Zeile Code schreiben zu müssen.

Technik im Detail in der API-Dokumentation: Authentifizierung, alle Endpoints, Webhooks, Fehlerformat und Rate Limits, Briefe ins Ausland, Swagger-UI.

Anwendungsfälle

Unternehmen aus verschiedensten Branchen nutzen unsere API, um den physischen Briefversand in ihre bestehenden Systeme und Prozesse zu integrieren.

ERP-Integration

Automatisierter Rechnungsversand direkt aus Ihrem ERP-System. Verbinden Sie Ihr ERP per REST-API oder über Zapier/Make (z.B. DATEV, lexoffice) und versenden Sie Rechnungen, Gutschriften und Belege automatisch per Brief.

CRM-Automatisierung

Briefversand getriggert durch CRM-Events und Workflows. Senden Sie Willkommensbriefe, Vertragsunterlagen oder Kündigungsbestätigungen automatisch, wenn ein CRM-Event ausgelöst wird.

Mahnwesen-Systeme

Automatische Mahnstufen mit physischem Briefversand. Konfigurieren Sie Zahlungserinnerungen, erste und zweite Mahnstufen sowie Inkassoankündigungen als automatisierten Workflow.

Dokumenten-Management

Integration in DMS für den automatischen Versand archivierter Dokumente. Lösen Sie den Briefversand direkt aus Ihrem Dokumenten-Management-System heraus; den Versandstatus fragen Sie per API ab oder erhalten ihn per Webhook.

Sie betreiben eine Plattform mit vielen Geschäftskunden? Werden Sie Software-Partner.

Ohne eigene Programmierung: Zapier, Make, n8n, DATEV & lexoffice.

Post-API: vom PDF zum Brief

Sie liefern digital ein, wir bringen den Brief auf Papier zur Deutschen Post

1. PDF senden
Ihr System sendet das PDF mit Empfängeradresse an die API oder lässt die Anschrift aus dem Adressfeld des PDFs lesen.
2. Druck und Kuvertierung
briefsenden.com druckt den Brief in S/W oder Farbe, ein- oder doppelseitig, und kuvertiert ihn.
3. Einlieferung bei der Deutschen Post
Der Brief wird frankiert und bei der Deutschen Post für die postalische Zustellung in Deutschland oder ins Ausland eingeliefert. Die Laufzeit hängt von Versandart und Zielland ab.
4. Status in Ihrem System
Den Bearbeitungsstatus fragen Sie per API ab oder erhalten Updates per Webhook. Bei Einschreiben ist die Sendungsnummer verfügbar, sobald sie vergeben wurde.

Sie überlegen, die E-POSTBUSINESS API der Deutschen Post direkt anzubinden? E-POST API und Hybridpost erklärt.

Was kostet ein Brief per API?

Ein Standardbrief in S/W kostet 91 Coins, ab 0,91 €¹ inklusive Druck, Kuvert und Porto – über die API genauso wie in der Weboberfläche. Sie laden Coins im Voraus auf, es gibt keine Grundgebühr. Die Kosten eines Briefs berechnen Sie vorab per POST /api/v1/estimate. Für Empfänger im Ausland kommt ein Porto-Zuschlag ab 78 Coins hinzu. Die Schätzung rechnet ihn ein, wenn Sie das Land in country angeben, und nennt in der Antwort das erkannte Land.

Alle Preise ansehen Briefe ins Ausland adressieren

¹ Beim besten Coin-Kurs (Aufladung von 25.000 Coins).

Häufig gestellte Fragen

Antworten zur Brief- und Post-API

API-Dokumentation Kostenlos registrieren und Test-Key erstellen Preise ansehen

Kostenloser Testmodus – keine Kreditkarte nötig

Jetzt integrieren

Starten Sie mit wenigen Zeilen Code und automatisieren Sie Ihren Briefversand über die REST-API. Kostenloser Sandbox-Modus inklusive.

Kostenlos registrieren Preise ansehen

Keine Grundgebühr Keine Mindestmenge Pay-per-Letter