Briefversand-API: Briefe direkt aus Ihrer Software versenden
Integrieren Sie den Briefversand direkt in Ihre Software – mit wenigen Zeilen Code. Unsere JSON-basierte REST-API verbindet Ihre Anwendung mit der Deutschen Post: DSGVO-konform, vollständig dokumentiert und mit kostenlosem Sandbox-Modus zum Testen.
Schnellstart in 5 Minuten
Vom Konto bis zum ersten API-Brief – in vier einfachen Schritten
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.
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.
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.
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 "color=bw" \ -F "duplex=simplex"
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_*). 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
Transparentes Rate Limiting mit 100 Requests pro Minute. Response-Header informieren über verbleibende Requests und Reset-Zeitpunkt.
Idempotency-Keys
Sichere Wiederholungen durch Idempotency-Keys bei jedem Request. Bei Netzwerkfehlern können Sie denselben Request erneut senden, ohne doppelte Briefe zu erzeugen.
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.
Authentication & Sicherheit
Sichere Authentifizierung mit API-Keys
Test-Keys bv_test_*
Für Entwicklung und Tests. Briefe werden simuliert, aber nicht physisch versendet. Keine Kosten, keine Coin-Abbuchung – ideal für die Integration in Ihre Entwicklungsumgebung und CI/CD-Pipelines.
Live-Keys bv_live_*
Für den Produktivbetrieb. Briefe werden gedruckt, kuvertiert und über die Deutsche Post zugestellt. Die Kosten werden automatisch von Ihrem Coin-Guthaben abgezogen.
Sicherheitsstandards
Alle API-Anfragen erfordern HTTPS – unverschlüsselte HTTP-Anfragen werden abgelehnt. Senden Sie Ihren API-Key im Header X-Api-Key. Die vollständige Authentifizierungsdokumentation finden Sie auf der API-Seite.
Endpoints im Überblick
Die wichtigsten API-Endpunkte für den Briefversand – von der Einlieferung bis zur Statusabfrage
| Methode | Endpoint | Beschreibung |
|---|---|---|
| POST | /api/v1/letters/simple | Brief versenden (PDF-Datei oder PDF-URL) |
| POST | /api/v1/letters/bulk | Bis zu 50 Briefe in einem Request |
| GET | /api/v1/letters/{id} | Status abfragen |
| POST | /api/v1/estimate | Kosten berechnen |
| GET | /api/v1/balance | Coin-Guthaben prüfen |
| POST | /api/v1/webhooks | Webhook registrieren |
Die vollständige Dokumentation aller Endpoints mit Request- und Response-Schemas finden Sie in der interaktiven API-Dokumentation.
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.
Hybridpost per 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 eingeliefert; Briefe, die vor 16:00 Uhr eingehen, am selben Werktag.
4. Status in Ihrem System
Jede Statusänderung meldet ein Webhook; bei Einschreiben kommt die Sendungsnummer dazu.
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 €1 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.
1 Beim besten Coin-Kurs (Aufladung von 25.000 Coins).
Fehlerbehandlung & Rate Limits
Transparente Limits und standardisiertes Fehlerformat für zuverlässige Integrationen
Rate Limits
Maximal 100 Requests pro Minute pro API-Key. Response-Header X-RateLimit-Remaining informiert über verbleibende Requests.
RFC 7807 Fehlerformat
Alle Fehler werden im standardisierten ProblemDetails-Format zurückgegeben – mit Typ, Titel, Statuscode und Detail-Nachricht für einheitliche Fehlerbehandlung.
Idempotency-Keys
Senden Sie einen Idempotency-Key-Header mit, um bei Netzwerkfehlern sicher wiederholen zu können – ohne doppelte Briefe.
Detaillierte Informationen zu HTTP-Statuscodes, Fehlerbehandlung und Retry-Strategien finden Sie in der API-Dokumentation.
Häufig gestellte Fragen
Antworten zur Briefversand-API
Jetzt integrieren
Starten Sie mit wenigen Zeilen Code und automatisieren Sie Ihren Briefversand über die REST-API. Kostenloser Sandbox-Modus inklusive.