Ein Brief per Post, mit einem Request.

Ihr System schickt Text oder ein fertiges PDF, wir drucken, kuvertieren und verschicken innerhalb Deutschlands. Idempotent über Ihre eigene ID, Preis vorab abfragbar, Zustellstatus abrufbar.

Konto und Token anlegen Vollständige Referenz

Endpunkte

Aufruf	Scope	Zweck
POST/api/v1/letters/quote	letters:read	Seitenzahl und Preis ermitteln, ohne zu versenden
POST/api/v1/letters	letters:send	Brief aus Text setzen (DIN 5008) und versenden
POST/api/v1/letters/pdf	letters:send	Fertiges PDF prüfen und unverändert versenden
GET/api/v1/letters/{id}	letters:read	Status und Zustellung abfragen

So funktioniert es

Token unter Einstellungen → API mit dem Scope letters:send anlegen. Der Token wird einmal angezeigt und nur als Hash gespeichert.

Über externalId sind Aufrufe idempotent: Dieselbe ID zweimal schicken verschickt nie einen zweiten Brief.

Preis pro Brief: 1,75 € erste Seite, +0,75 € je weitere Seite, Einschreiben +3,75 €. Abgebucht vom Guthaben.

curl -X POST https://briefdiener.de/api/v1/letters \
  -H "Authorization: Bearer bd_…" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "mahnung-2026-0142",
    "sender":    { "company": "Muster GmbH", "address": "Hauptstr. 1\n10115 Berlin" },
    "recipient": { "name": "Max Beispiel", "address": "Lindenweg 4\n40210 Düsseldorf" },
    "subject":   "Zahlungserinnerung Rechnung 2026-0142",
    "content":   "Sehr geehrter Herr Beispiel,\n\n…",
    "registered": false
  }'

Grenzen

Nur Empfänger in Deutschland.
Gesetzte Textbriefe tragen am Fuß einen kleinen BriefDiener-Hinweis, PDFs werden unverändert gedruckt.
Noch keine Webhooks: den Status fragen Sie ab.
Guthaben statt Rechnungskauf.