Eigene Automatisierung (API)

Für Fortgeschrittene: Statt Mails weiterzuleiten, schickt ihr sie mit einem eigenen Skript, einem iPhone-Kurzbefehl, Zapier oder n8n direkt an Hüsli. Hüsli behandelt sie wie weitergeleitete Mails: Termine landen im Kalender, Pakete in der Paketliste.

So geht's

1. Öffnet Einstellungen › Kalender & Mail und tippt unter Post an Hüsli auf Für Fortgeschrittene: eigene Automatisierung.
2. Unter Deine persönliche Adresse steht eure API-Adresse, zuerst verdeckt. Tippt auf Kopieren (oder auf Anzeigen, um sie zu sehen).
3. Die Adresse besteht aus https://huesli.app/app/api/inbox und eurem Schlüssel hinter ?key=. Schickt den Schlüssel am besten im Header X-Huesli-Key statt in der Adresse.
4. Euer Skript schickt eine POST-Anfrage mit JSON (Beispiele unten). Hüsli antwortet sofort mit dem, was es abgelegt hat.
5. Prüft das Ergebnis im Kalender oder unter Pakete. Jede abgelegte Mail erscheint bei den Eltern auch unter der Glocke.

Die Anfrage

• Methode und Adresse: POST https://huesli.app/app/api/inbox
• Header: Content-Type: application/json und X-Huesli-Key: DEIN-SCHLÜSSEL
• messages (Pflicht): eine Liste mit bis zu 40 Mails. Pro Mail: - id: eine eindeutige Kennung der Mail, z. B. die Message-ID. Dieselbe id übernimmt Hüsli nie zweimal. - from: Absender, z. B. schule@example.ch - subject: Betreff - date: wann die Mail kam, z. B. 2026-10-26T08:15:00+01:00 - body: der Text der Mail - html (freiwillig): die HTML-Fassung, hilft bei Paket-Mails - type (freiwillig): "parcel" für eine Paket- oder Versandmail – sie landet dann bei Pakete statt im Kalender (dafür muss das Add-on Pakete eingeschaltet sein)
• owner (freiwillig, neben messages): der Vorname oder die Personen-Kennung aus eurer Familie, z. B. "Marc". Dann gehören die Einträge dieser Person; sonst der ganzen Familie.

Beispiel mit curl

curl -X POST 'https://huesli.app/app/api/inbox' \
  -H 'Content-Type: application/json' \
  -H 'X-Huesli-Key: DEIN-SCHLÜSSEL' \
  -d '{"owner":"Marc","messages":[{"id":"mail-2026-001","from":"schule@example.ch","subject":"Elternabend am 12. November um 19.30 Uhr","date":"2026-10-26T08:15:00+01:00","body":"Liebe Eltern …"}]}'

Beispiel mit iPhone-Kurzbefehlen

1. Öffnet die App Kurzbefehle und legt einen neuen Kurzbefehl an.
2. Fügt die Aktion «Inhalte von URL abrufen» hinzu und tragt https://huesli.app/app/api/inbox ein.
3. Wählt bei «Methode» POST, fügt den Header X-Huesli-Key mit eurem Schlüssel hinzu und wählt bei «Anfragetext» JSON.
4. Legt im JSON ein Feld messages (Liste) an mit einem Eintrag, der id, from, subject, date und body enthält – zum Beispiel aus dem Teilen-Menü der Mail-App oder aus einer Automation.
5. Führt den Kurzbefehl einmal aus und prüft den Kalender.

Die Antwort

Hüsli antwortet mit JSON, zum Beispiel:

{"ok":true,"owner":"me-…","created":[{"title":"Elternabend am 12. November um 19.30 Uhr","start":"2026-11-12T19:30","allDay":false}],"parcels":[],"handled":[]}

• created: die neuen Termine (Titel, Beginn, ganztägig oder nicht)
• parcels: die erkannten Pakete (Shop, Status, erwartet am)
• owner: wem die Einträge gehören, oder null für die ganze Familie

Wenn es nicht klappt

• 403 «Nicht erlaubt.»: Der Schlüssel stimmt nicht – zum Beispiel, weil ihr einen neuen erzeugt habt. Kopiert die Adresse neu.
• Nichts in created: Diese Mail kam schon einmal (gleiche id, oder gleicher Betreff am gleichen Tag), oder es waren mehr als 40 Mails – Hüsli nimmt die ersten 40.
• Paket-Mails ohne "type":"parcel" landen als Termin oder Hinweis im Kalender.

Gut zu wissen

• Der Schlüssel ist wie ein Hausschlüssel: Wer die Adresse kennt, kann Einträge in euren Kalender schreiben. Teilt sie mit niemandem und zeigt sie nicht auf Screenshots.
• Mit Neuen Schlüssel erzeugen gilt die alte Adresse sofort nicht mehr. Die Weiterleitungsadresse für Post an Hüsli bleibt gleich.
• Den Bereich sehen nur Eltern. Post an Hüsli gehört zu Pro (während der Beta gratis).