Postkarten API: echte Karten aus deinem System
Du hast ein CRM voll mit Kunden, einen Shop voll mit Bestellungen oder einen Workflow, der heute schon E-Mails verschickt. Das nächste Stück Aufmerksamkeit liegt im Briefkasten – und dafür gibt es die EchtPost-API.
Account erstellen dauert eine Minute, den API-Key findest du direkt danach im Konto. Du löst aus, wir drucken, frankieren mit echter Briefmarke und geben die Karte zur Post. Den Briefkasten erreicht sie dann auf dem normalen Postweg.
Jan hat die Anbindung an unser CRM an einem Nachmittag erledigt. Eine halbe Stunde Doku lesen, ein erster API-Call mit der eigenen Adresse als Empfänger – zwei Tage später lag die Karte in seinem Briefkasten. Genauso soll das laufen, egal ob du selbst Code schreibst oder jemanden vorbeischickst, der das für dich tut.
Was du damit konkret machen kannst
Drei Beispiele, die wir in der Wildnis gesehen haben:
- Onboarding bei einem SaaS-Anbieter: Neuer Trial-Account → drei Tage später eine handschriftlich wirkende Willkommens-Postkarte. Ausgelöst von einem Webhook aus dem Auth-System.
- Reaktivierung im Online-Shop: Kunde hat sechs Monate nichts gekauft → automatisch eine Karte mit personalisiertem Rabatt-Code. Ausgelöst von einem Workflow, der täglich die Bestellhistorie scannt.
- Geburtstage aus dem CRM: Stammkunde wird X Jahre alt → automatische Geburtstagskarte mit Foto und Unterschrift des Account Managers.
Du brauchst dafür keinen Druckerei-Vertrag, keine Vorratshaltung und kein Auge auf Briefmarken. Nur einen Auslöser in deinem System – den Rest übernehmen wir. Mehr dazu, wie das im Kundenbindungs-Mix aussieht, haben wir an anderer Stelle aufgeschrieben.
So funktioniert's – in drei Schritten
Kein Sales-Termin vorab, kein Freischaltungs-Ticket, kein Schluck Wasser zwischen Klick und Karte:
- Account anlegen, API-Key kopieren. Du registrierst dich kostenlos. Im Konto findest du sofort deinen API-Key – kein Freischaltungs-Ticket, kein Sales-Anruf vorab.
- Anbinden, wie es zu dir passt. Direkt per REST-Call gegen
api.echtpost.de/v2, oder aus einem Workflow-Tool deiner Wahl. Du schickst uns Empfänger, Motiv und Text – mehr brauchen wir nicht. - Wir drucken, frankieren und geben zur Post. Werktäglich produzieren wir die Karten und übergeben sie am Folgetag an die Deutsche Post. Echte Karten, echte Briefmarke. Den Rest macht die Post – innerhalb Deutschlands rechnest du danach mit den üblichen 1–3 Werktagen. Sobald die Karte raus ist, schicken wir dir ein
card.sent-Event per Webhook – mehr Status-Geräusch brauchst du in der Regel nicht.
API-Key sofort verfügbar
Sobald dein Account angelegt ist, liegt der API-Key im Konto. Kein Anruf, kein Wartezimmer.
Bis zum Druck stornierbar
Solange eine Karte noch nicht im Druck ist, kannst du sie per API wieder zurückziehen. Falsche Adresse, falscher Tag – kein Problem.
Eine Karte oder hundert
Du übergibst Empfänger einzeln, als Liste oder als Gruppen-ID – ein API-Call, beliebig viele Karten. Adressen können bei uns gespeichert oder ad-hoc mitgeschickt werden.
Versand-Webhook
Sobald wir die Karte an die Post übergeben haben, schicken wir dir ein card.sent-Event mit Signatur. Kein Polling, kein Erraten, ob's raus ist.
Echte Briefmarke
Jede Karte bekommt eine echte Briefmarke – sie wird als persönliche Post wahrgenommen, nicht als Werbung.
Versand auf Termin
Pro Karte gibst du an, wann wir sie in Druck geben sollen. Praktisch für Geburtstags-Workflows: API-Call jetzt, Druck ein paar Tage vor dem Termin – Postlaufzeit eingerechnet.
Zwei Wege, eine Karte zu schicken
Wir haben uns für zwei klare API-Pfade entschieden, statt fünf halbgare anzubieten. Welcher zu dir passt, hängt davon ab, wer im Team Layout und Text pflegt.
Variante A: Template + Trigger
Du legst Motiv, Layout und Wunschtext einmalig als Template im EchtPost-Account an. Marketing pflegt das Template; aus dem Code feuerst du nur noch die template_id plus die Empfänger.
Wir nennen das den „Marketing-Mode“: Wer Text oder Bild ändern will, klickt sich das im Account zusammen – kein Deploy, kein Ticket an die IT.
curl -X POST https://api.echtpost.de/v2/cards/from_template \
-H "Authorization: Bearer $ECHTPOST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"template_id": 12345,
"recipients": [
{
"firstname": "Anna",
"lastname": "Müller",
"street": "Hauptstraße 1",
"zipcode": "10115",
"city": "Berlin",
"country": "DE"
}
],
"deliver_at": "2026-06-21"
}'Variante B: Komplett aus dem Code
Du übergibst alles in einem Request: Motiv, Text und Empfänger. Maximale Flexibilität, ein Call pro Karte – ideal, wenn der Text ohnehin dynamisch aus deinem System kommt (Bestellnummer, Vorname, Lieblingsprodukt).
Optional schickst du den Text vorher gegen cards/preview_fit – dann weißt du, ob er auf die Karte passt, bevor du den Request zur Erstellung der Karte abschickst.
curl -X POST https://api.echtpost.de/v2/cards \
-H "Authorization: Bearer $ECHTPOST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"motive_id": 789,
"content": "Hallo Anna,\n\nschön, dass du dabei bist!\nViele Grüße aus Köln,\nMoritz",
"recipients": [
{
"firstname": "Anna",
"lastname": "Müller",
"street": "Hauptstraße 1",
"zipcode": "10115",
"city": "Berlin",
"country": "DE"
}
]
}'Lieber per Workflow-Tool als im eigenen Repo?
Funktioniert genauso. Unsere REST-API ist eine ganz normale HTTPS-Schnittstelle – n8n, Zapier oder Make rufen sie über deren generische HTTP-Schritte auf. Ein Make-Szenario, das täglich Bestellungen ausliest und pro Treffer einen Request gegen api.echtpost.de/v2/cards/from_template schickt, ist in einer halben Stunde gebaut. Code im klassischen Sinn schreibst du dafür keinen, ein bisschen JSON und ein paar Variablen aber schon.
Du arbeitest mit Claude, Cursor oder ChatGPT? Dann kannst du unseren MCP-Server einbinden und Postkarten direkt aus dem Chat verschicken. Mehr dazu auf Postkarten MCP – die Seite kommt mit eigenem Brief, hier nehmen wir's nur als Teaser.
Bereit, Postkarten an dein System zu hängen?
Account anlegen dauert eine Minute, der API-Key liegt direkt im Konto. Wenn dir die Doku unterwegs Englisch wird – willkommen im Club, Marken-Englisch ist nun mal Standard – melde dich, dann gehen wir das gemeinsam durch.
Häufige Fragen
Wie schnell komme ich an einen API-Key?
Sofort. Account anlegen dauert eine Minute, der Key liegt direkt im Konto-Bereich. Kein Freischaltungs-Termin, kein Sales-Anruf vorab. Wer MCP nutzen will, kann den Server an derselben Stelle aktivieren.
Brauche ich Programmierkenntnisse, um EchtPost zu nutzen?
Nicht zwingend. Über generische Workflow-Tools wie n8n, Zapier oder Make kannst du unsere API in ein paar Klicks anbinden. Wer mit Claude oder ChatGPT arbeitet, hängt unseren MCP-Server dran. Wer es lieber selbst baut, findet eine vollständige REST-API.
Funktioniert das mit meinem CRM (HubSpot, Salesforce, Pipedrive …)?
Ja – entweder über die genannten Workflow-Tools, die alle gängigen CRMs anbinden, oder direkt über die API. Falls ein Datenfeld bei dir anders heißt als bei uns: melde dich, wir gehen das Feld-Mapping gemeinsam durch.
Was ist MCP – und brauche ich das?
MCP (Model Context Protocol) ist ein offener Standard, mit dem AI-Tools wie Claude oder ChatGPT auf externe Systeme zugreifen. Unser MCP-Server macht die EchtPost-API direkt im Chat nutzbar: „Schick Anna eine Geburtstagskarte“ – und es passiert. Wer keine KI-Agenten einsetzt, braucht MCP nicht.
Auf welcher Sprache ist die Doku?
Die API-Doku ist Englisch. Dieses Marketing, der Support und der Vertrag sind Deutsch. Wenn dir das Englisch im Weg steht, melde dich – wir helfen weiter.
Was kostet eine Karte?
Stückpreis je nach Volumen und Format, ab kleinen einstelligen Euro-Beträgen. Keine Setup-Gebühr, keine Mindestabnahme. Die genaue Staffel findest du auf der Preisseite.
Wie schnell ist eine Karte beim Empfänger?
Werktäglich produzieren wir die Karten, am Folgetag übergeben wir sie an die Post. Innerhalb Deutschlands rechnest du danach mit den üblichen 1–3 Werktagen – mehr versprechen können wir nicht, weil ab Versand die Post übernimmt.
Gibt es einen Sandbox-Modus zum Testen?
Stand heute nicht. Was du stattdessen tun kannst: deine eigene Adresse als Empfänger eintragen und eine echte Karte an dich selbst schicken. Solange sie nicht im Druck ist, kannst du sie jederzeit wieder abbrechen – per API, per MCP oder einfach im EchtPost-Konto. Erst wenn die Karte tatsächlich rausgeht, kostet sie dich den normalen Stückpreis (im einstelligen Euro-Bereich) und liegt dafür im eigenen Briefkasten. Wenn dir ein echter Sandbox-Modus fehlt, sag uns Bescheid – das hilft uns bei der Priorisierung.
Preise: Was kostet der Versand?
Einzelne Postkarte
Rabatt bei monatlich mindestens 10 Postkarten: Gutschrift über 0,50 Euro für jede verschickte Postkarte.
Postkarten-Mailing
Eine Postkarte an viele Empfänger gleichzeitig. Je mehr Karten, desto günstiger der Stückpreis. Alle Mailing-Rabatte einsehen
Alle Preise sind inklusive einer echten, aufgeklebten Briefmarke.
Postkarten as a Service
Mehr SaaS-Use-Cases mit Postkarten – von Onboarding bis Reaktivierung – findest du auf unserer Customer-Lifecycle-Seite.
Marketing Automation
Wie sich Postkarten in deine bestehende Automation-Strecke einfügen – ohne dass dein Stack umgebaut werden muss.
Geburtstagsgrüße
Den Klassiker – Geburtstagspost per CRM-Trigger – kann die API genauso oder du nutzt unsere fertige Geburtstags-Funktion.
Das sagen unsere Kunden über EchtPost
Bärbel Küppers
Frau Immer und Herr Ewig
Die Postkarten-Mailings, die wir mit EchtPost verschicken, sind aufmerksamkeitsstark, persönlich und emotional - und kommen bei unseren Kunden gut an. Genauso muss gutes Marketing sein!
Simon Böffgen
42he Software
EchtPost liefert uns als Software-Unternehmen einen echten Mehrwert: Wir verschicken Postkarten zur Reaktivierung und Kundenbindung und erzielen damit tolle Ergebnisse.
James Barton
pascom GmbH & Co. KG
Der EchtPost Kundenservice ist top! Schnell, freundlich, professionell und sehr hilfreich mit Feedback und Empfehlungen. Auch die Qualität der gedruckten Postkarten überzeugt uns.
Emanuele Carello
Ergo Versicherungsbüro
Carello und Kollegen
Bereits seit mehreren Jahren verschicken wir unsere Weihnachtskarten über EchtPost. Die Postkarten mit einem Foto unseres Teams kommen bei den Kunden sehr gut an. Und für uns ist der Arbeitsaufwand absolut überschaubar.
Jennifer Novak
bbz Berufsbildungszentrum
Wir setzen bei der Vermarktung unserer Events und Weiterbildungsangebote auf EchtPost. Wir sind überzeugt davon, dass Postkarten eine erfrischende Möglichkeit der Kundenkommunikation darstellen und haben damit sehr gute Erfahrungen gemacht.
Christoph Richter
Wein aus Südtirol
Ich nutze EchtPost um Bestandskunden auf besondere Angebote in meinem Onlineshop aufmerksam zu machen. Die Bestellungen im Anschluss an den Versand der Postkarten-Mailings zeigen, dass das funktioniert.
Einfach anrufen
Du erreichst uns
in unserem Kölner Büro
unter 0221 - 177 383 93.
Schreib uns
Nutz unser Kontaktformular
um uns eine Nachricht zu hinterlassen.
Rückruf vereinbaren
Wähl einen dir
passenden Termin und wir
melden uns telefonisch.