Direct-Mail-API: persönliche Briefe und Postkarten aus Ihrer eigenen Software
Mit der API von Yotru verschickt Ihr CRM, Ihr Onlineshop oder Ihr Buchungssystem gedruckte, persönliche Briefe von selbst, in Deutschland auch Postkarten. Sie legen einen Brief an, übergeben Empfänger und geben frei. Eine Druckvorlage brauchen Sie nicht: Yotru baut den Brief aus Ihrer Website, auf Deutsch und in der Sie-Form. Jeder Brief trägt den Namen des Empfängers und einen eigenen QR-Code, damit Sie sehen, wer reagiert.
Was Sie bekommen
- Keine Gestaltung nötig
- Sie schicken Ihre Website-Adresse mit, und Yotru baut den Brief mit Ihrem Logo und Ihren Farben. Oder Sie wählen eine Vorlage und senden Ihren eigenen Text.
- Persönlich für jeden Empfänger
- Jeder Brief hat den Namen des Empfängers, einen eigenen QR-Code und eine eigene Landingpage. Eigene Felder pro Empfänger sind möglich.
- Sehen, wer reagiert
- Jeder Scan gehört zu genau einem Empfänger. Sie sehen ihn im Dashboard und bekommen auf Wunsch sofort eine Nachricht per E-Mail oder Slack.
- Kostenlos bauen und testen
- Briefe anlegen, Vorschauen abrufen und Empfänger übergeben kostet nichts. Sie zahlen, wenn Sie eine Kampagne freigeben.
- Geprüft vor dem Druck
- Nach Ihrer Freigabe sieht sich bei uns ein Mensch die Sendung an, bevor sie in den Druck geht.
- Druck und Porto inklusive
- Ein Preis pro Brief für Druck, Umschlag und Zustellung, nach Deutschland, Österreich, in die Schweiz und in 13 weitere Länder.
So funktioniert es
| Schritt | Aufruf | Was passiert |
|---|---|---|
| 1 | POST /v1/cards | Sie legen einen Brief oder eine Postkarte an, mit product, country und language. Was Sie weglassen, kommt aus der Vorlage oder von Ihrer Website. |
| 2 | POST /v1/recipients | Sie übergeben bis zu 1.000 Empfänger pro Aufruf. Der erste Aufruf eröffnet automatisch eine Kampagne. |
| 3 | POST /v1/campaigns/{id}/approve | Sie geben frei. Die Antwort enthält einen Zahlungslink, nach der Zahlung geht die Kampagne in den Druck. |
curl -X POST https://api.yotru.com/v1/cards \
-H "Authorization: Bearer $YOTRU_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Herbstangebot","product":"letter","country":"DE","website":"https://beispiel.de"}'
curl -X POST https://api.yotru.com/v1/recipients \
-H "Authorization: Bearer $YOTRU_KEY" \
-H "Content-Type: application/json" \
-d '{"cardId":"CARD_ID","recipients":[{"name":"Anna Schmidt","street":"Hauptstraße","houseNumber":"1","postcode":"10115","city":"Berlin","country":"DE"}]}'Ein Vorschau-Aufruf liefert den Brief genau so, wie er gedruckt wird. So prüfen Sie ihn, bevor Sie freigeben.
Was Sie damit bauen können
- Rückgewinnungsbriefe. Ihr Shop schreibt Kunden an, die seit sechs Monaten nichts bestellt haben.
- Jubiläums- und Verlängerungsbriefe. Ihr CRM schickt einen Brief, wenn jemand ein Jahr Kunde ist.
- Nachfassen. Ihr Buchungssystem schickt eine Postkarte nach dem ersten Besuch oder einem verpassten Termin.
- Post für Ihre eigenen Kunden. Ihre Software bietet ihren Nutzern Briefe an, und Sie sind bei uns der Absender.
Was es kostet
Derselbe Preis wie bei einer Bestellung über die Website, mit Druck, Umschlag und Porto. Ein Brief nach Deutschland kostet bei 100 Stück 2,49 € und bei 5.000 Stück 1,35 € pro Stück, eine Postkarte 2,79 € und 1,42 €, jeweils zzgl. MwSt. Es gibt kein Minimum: Unter 100 Stück gilt der Preis für 100. Anlegen und Testen ist kostenlos.
Gut zu wissen, bevor Sie loslegen
- Postkarten gehen nach Deutschland, in die Niederlande, nach Großbritannien, Kanada und in die USA. Briefe gehen in alle 16 Länder, darunter Österreich und die Schweiz.
- Briefe bauen Sie aus vier Vorlagen, Postkarten aus zehn. Sie füllen sie mit Ihrem Text, Ihren Farben, Ihrem Logo und Ihrem Foto.
- Ein Brief geht in ein Land, und seine Empfänger wohnen dort. Bis zu 1.000 Empfänger passen in einen Aufruf, und mit einem Idempotency-Key im Header ist ein wiederholter Aufruf sicher.
Fragen zur API
- Gibt es einen Testmodus oder eine Sandbox?
- Nein, und Sie brauchen keinen. Briefe anlegen, Vorschauen abrufen und Empfänger übergeben kostet nichts und verschickt nichts. Nur die Freigabe einer Kampagne kostet Geld.
- Wie bekomme ich einen API-Schlüssel?
- Legen Sie ein Konto an und öffnen Sie Einstellungen, dann Integrationen und API-Schlüssel. Der erste Schlüssel entsteht beim Öffnen dieser Seite und wird einmal angezeigt. Sie müssen Inhaber oder Admin sein und Ihre E-Mail-Adresse bestätigt haben.
- Schreibt die API auf Deutsch?
- Ja. Ohne Angabe ist ein Brief nach Deutschland, Österreich oder in die Schweiz auf Deutsch und spricht den Empfänger mit Sie an. Mit language wählen Sie eine der anderen neun Sprachen.
- Kann der Brief eine bedruckte Rückseite haben?
- Ja. Mit backSide: true druckt Yotru eine zweite Seite auf die Rückseite, für 0,25 € mehr pro Brief.
- Was passiert mit einer falschen Adresse?
- Dieser Empfänger wird mit einem Grund abgelehnt, etwa address oder duplicate, und der Rest der Liste geht durch.
- Gibt es Limits?
- Pro Schlüssel 120 Aufrufe pro Minute und 300 Aufrufe pro Tag, die Briefe anlegen oder ändern oder Fotos mitschicken.
- Kann ich sehen, wer auf einen Brief reagiert?
- Ja. Jeder Brief hat einen eigenen QR-Code, jeder Scan gehört also zu einem Empfänger. Sie sehen ihn im Dashboard und können sofort benachrichtigt werden.
- Funktioniert das mit meinem CRM oder Shop?
- Jedes System, das einen HTTPS-Aufruf machen kann, kann die API nutzen. Mit HubSpot verbinden Sie Ihre Listen auch ohne Code im Dashboard.
Warum wir sie so gebaut haben: Briefe per API versenden: Werbebriefe und Postkarten direkt aus Ihrer Software.