Über die Smoobu-API liest und schreibt ein Tool oder dein eigener Code deine Buchungsdaten, und Webhooks melden deinem System sofort, sobald sich etwas ändert. Verwaltet wird das alles unter Fortgeschrittene Einstellungen > API-Schlüssel. Greif dazu, wenn ein Tool Zugriff auf deine Buchungen braucht oder du deine eigene Integration baust. Das ist nur etwas für erfahrene Nutzer: Der Kundensupport hilft nur bei Integrationsproblemen mit Marktplatz-Partnern, bei eigenen Entwicklungen kann unser Support-Team nicht weiterhelfen.
Bevor du startest
Das brauchst du, bevor du die API nutzen kannst:
- Ein kostenpflichtiges Smoobu-Konto. In der kostenlosen Testphase lassen sich keine Schlüssel erzeugen.
- Den Login des Hauptkontos. Nur das Hauptkonto hat API-Schlüssel. Der Login eines Teammitglieds hat keine Seite API-Schlüssel. Du kannst eine Integration also nicht auf einige deiner Unterkünfte beschränken, indem du ihr den Zugang eines Teammitglieds gibst.
- Das Bewusstsein, dass ein Schlüssel Zugriff auf dein ganzes Konto gibt. Behandle einen Schlüssel wie ein Passwort. Eine Ausnahme gibt es: Die personenbezogenen Daten deiner Gäste kann ein Schlüssel nur lesen, wenn du es erlaubst.
Einen API-Schlüssel erstellen
- Öffne in Smoobu Fortgeschrittene Einstellungen und dann API-Schlüssel.
- Klicke oben rechts auf Neu erstellen.
- Gib im Fenster API-Token erstellen unter Label (optional) einen kurzen Namen ein, damit du den Schlüssel später wiedererkennst. Braucht das Tool die Namen, E-Mail-Adressen oder Telefonnummern deiner Gäste, aktiviere Zugriff auf personenbezogene Gästedaten erlauben. Braucht es sie nicht, lass das Kontrollkästchen deaktiviert. Klicke auf Absenden.
- Smoobu zeigt Token erstellt mit deinem neuen Schlüssel im Feld Label und darunter deinem Secret im Feld Verschlüsselung. Kopiere beides über die Kopier-Buttons und speichere es sofort an einem sicheren Ort, zum Beispiel in einem Passwortmanager: Smoobu zeigt das Secret nur ein einziges Mal an. Hake Ich habe meine Verschlüsselung kopiert an und klicke auf Schließen.
- Der neue Schlüssel erscheint mit seinem Label in der Liste, und du kannst ihn dort jederzeit wieder aus der Spalte Verschlüsselung kopieren. Das Secret lässt sich nicht noch einmal anzeigen: Verlierst du es, widerrufe den Schlüssel und erstelle einen neuen. Füge Schlüssel und Secret in das Tool oder den Code ein, der Zugriff braucht.
Jeder Schlüssel gibt Zugriff auf dein ganzes Konto. Nur einen Teil kannst du zurückhalten: die personenbezogenen Daten deiner Gäste (Namen, E-Mail-Adressen, Telefonnummern, Notizen und Nachrichten). Die Spalte Gästedaten in der Schlüsselliste zeigt, welche Schlüssel diese Daten lesen können. Nutzt du mehrere Integrationen, gib jeder einen eigenen Schlüssel, dann kannst du einen widerrufen, ohne die anderen lahmzulegen. Und willst du einen Schlüssel stilllegen, klicke daneben auf Rückgängig machen: Jede Anfrage, die ihn noch nutzt, funktioniert sofort nicht mehr.
Schlüssel, die du vor dem 26. Oktober 2026 erstellt hast
Schlüssel, die es schon gab, bevor der Zugriff auf Gästedaten eingeführt wurde, können die personenbezogenen Daten deiner Gäste noch bis zum 30. November 2026 lesen. Nach diesem Datum liefern sie keine Gästedetails mehr, außer du hast für sie Gästedaten erlaubt. Braucht ein Tool Gästedetails, erlaube vor dem 30. November auf der Seite API-Schlüssel Gästedaten für seinen Schlüssel. So funktioniert das Tool weiter. Braucht ein Tool sie nicht, musst du nichts tun: Ab dem 1. Dezember liest sein Schlüssel keine Gästedaten mehr.
Schütze deinen Schlüssel
Ein Schlüssel ist ein Passwort zu deinem ganzen Konto. Behandle ihn also wie ein Passwort:
- Schreibe einen Schlüssel nie direkt in deinen Code. Das gilt für API-Schlüssel, Passwörter und Tokens gleichermaßen: Wer den Code sehen kann, sieht auch den Schlüssel.
-
Speichere Zugangsdaten stattdessen in Umgebungsvariablen, zum Beispiel in einer
.env-Datei, die dein Code zur Laufzeit ausliest. -
Halte die
.env-Datei aus der Versionsverwaltung heraus. Trage.envund jede andere Konfigurationsdatei mit geheimen Werten in deine.gitignoreein, damit sie nie zu GitHub hochgeladen werden. - Mach deine Repositorys privat. Wenn dein Integrationscode auf GitHub liegt, stelle die Sichtbarkeit des Repositorys sofort auf Private, besonders wenn der Code deine eigene, geschützte Arbeit ist.
Gelangt ein Schlüssel doch nach außen, widerrufe ihn auf der Seite API-Schlüssel und erstelle einen neuen; der alte funktioniert dann sofort nicht mehr.
Einen Webhook einrichten
Ein Webhook meldet deinem eigenen System, wenn sich in Smoobu etwas ändert, sodass dein System nicht ständig nachfragen muss.
- Suche auf der Seite API-Schlüssel das Feld Webhook-URLs.
- Gib die Adresse auf deinem Server ein, die die Updates empfangen soll.
- Klicke auf Speichern. Du kannst mehr als einen Webhook hinzufügen.
Smoobu sendet jedes Update nur einmal und versucht es nicht erneut. Antwortet dein Server nicht innerhalb von 60 Sekunden, geht dieses Update verloren. Nutze die API, um Ereignisse abzurufen, die dir möglicherweise entgangen sind. Um zu sehen, was Smoobu sendet, bevor du dich darauf verlässt, trag eine temporäre Adresse von einem Dienst wie webhook.site ein und lege eine Testbuchung an.
Smoobu sendet einen Webhook für diese Ereignisse:
- eine neue Buchung
- eine aktualisierte Buchung
- eine stornierte Buchung
- eine gelöschte Buchung
- eine Änderung an Preisen, Mindestaufenthalt oder Verfügbarkeit
- ein abgeschickter Online-Check-in
- eine neue Nachricht
Diese Liste ist vollständig. Für Bewertungen gibt es keinen Webhook, und es gibt keine versteckten oder undokumentierten Ereignisse. Änderungen an den Preispositionen einer Buchung (Preiselemente) gehen nur an Integrationspartner, die Smoobu einrichtet, nie an die Adressen, die du hier einträgst.
Das Feld enthält nur die Webhooks, die du selbst einträgst. Manche Marketplace-Partner registrieren ihre eigenen Webhooks über die API von Smoobu, sobald du sie verbindest. Du musst die Adresse eines Partners also nie in dieses Feld eintragen.
Welche Daten Smoobu genau mit jedem Ereignis sendet, steht in der Entwicklerdokumentation (docs.smoobu.com): Klicke auf der Seite API-Schlüssel auf Hier geht es zur Dokumentation der API. Dieselbe Dokumentation enthält die vollständige Endpunkt-Referenz und Code-Beispiele.
Stattdessen ein Marktplatz-Tool anbinden
Ist das gewünschte Tool schon ein Smoobu-Marktplatz-Partner, etwa ein Preistool oder ein Check-in-Tool, gibst du gar keinen Schlüssel weiter, sondern folgst einfach den Anleitungen im Smoobu-Marktplatz. Marktplatz-Partner kannst du jederzeit trennen; das kappt ihren Zugriff sofort, beendet dein Abonnement für den Dienst aber nicht unbedingt. Nimm diesen Weg, wo es ihn gibt, und erzeuge einen eigenen Schlüssel nur für ein Tool oder Skript, das kein gelisteter Partner ist.
Deine Anfragen mit HMAC signieren
Smoobu stellt den direkten API-Zugriff auf signierte Anfragen (HMAC) um, sodass jeder Aufruf belegt, dass er echt und unverändert ist. Hast du deine eigene Integration gebaut, ergänze die Signierung vor dem 31. Oktober 2026; danach werden unsignierte Anfragen abgelehnt. In der Übergangszeit funktionieren beide, signiert und unsigniert, du kannst also umstellen und testen, ohne dein laufendes Setup zu unterbrechen.
Wer etwas tun muss:
- Marktplatz-Partner (Preistools, Check-in-Tools und Ähnliches): nichts zu tun, der Partner kümmert sich darum.
- Portalverbindungen (Airbnb, Booking.com und andere Portale): nicht betroffen.
- Dein eigenes Skript oder deine eigene Integration, die du selbst kontrollierst: Ergänze die Signierung mit den Schritten unten.
- Ein Tool, das du nicht kontrollierst, in das du aber deinen Schlüssel eingefügt hast: Folge den Schritten 1 und 2 unten, um die Signierung zu aktivieren. Wende dich danach an den externen Anbieter und teile ihm deinen neuen API-Schlüssel und dein Secret mit, damit er sich mit Smoobu verbinden kann.
So richtest du die Signierung ein:
- Erstelle einen Schlüssel wie oben unter Einen API-Schlüssel erstellen beschrieben. Jeder Schlüssel, den du dort erstellst, kommt mit einem Secret, das im Fenster Token erstellt ein einziges Mal angezeigt wird.
- Speichere das Secret sicher. Verlierst du es, erstelle einen neuen Schlüssel und aktualisiere deine Integration mit dem neuen Schlüssel und Secret, bevor du den alten widerrufst, damit deine Integration zwischendurch nie stehen bleibt.
- Passe deine Integration so an, dass sie jede Anfrage signiert. Zusätzlich zu deinem Schlüssel sendet jede Anfrage vier weitere Header:
- X-API-Key (dein Schlüssel),
-
X-Timestamp (die aktuelle Zeit im UTC-Format ISO 8601 (Beispiel:
2026-04-01T12:00:00Z)), - X-Nonce (ein eindeutiger Wert, den du nie wiederverwendest; nutze UUID v4),
- und X-Signature (die HMAC-SHA256-Signatur). Wie du die Signatur bildest und wie jeder Header genau aufgebaut ist, steht in der Entwicklerdokumentation: Die vollständige technische Anleitung mit Code-Beispielen findest du hier: docs.smoobu.com/#hmac-authentication
Buchungen in dein eigenes System holen
Deine Buchungsdaten kannst du über die API in deine eigene Webseite oder dein eigenes System holen. Wer das System betreut, braucht dafür die API-Dokumentation von Smoobu und den Endpunkt für Buchungen, GET /api/reservations, zusammen mit dem API-Schlüssel deines Kontos. Namen und Kontaktdaten der Gäste werden nur übertragen, wenn der Schlüssel Gästedaten lesen darf. Einen Hinweis gibst du am besten an deinen Entwickler weiter: Von den Datumsparametern dieses Endpunkts funktionieren im Moment nur from und to.
Häufige Probleme
Neu erstellen fehlt oder tut nichts
Auf Testkonten ist das Erzeugen von Schlüsseln abgeschaltet.
Mein API-Schlüssel funktioniert nicht mehr
Smoobu schaltet jeden Schlüssel ab, der länger als 90 Tage nicht benutzt wurde. Du bekommst vorher keine Warnung, und ein abgeschalteter Schlüssel lässt sich nicht wieder einschalten. Erstelle wie oben beschrieben einen neuen Schlüssel und trag ihn mit seinem Secret in dein Tool oder deinen Code ein.
Kündigst du deinen kostenpflichtigen Tarif, werden deine Schlüssel gesperrt. Sie funktionieren wieder, wenn du innerhalb von 90 Tagen erneut ein Abo abschließt.
Gästenamen und Gästedetails kommen leer zurück
Der Schlüssel hat keinen Zugriff auf die personenbezogenen Daten deiner Gäste. Namen, E-Mail-Adressen, Telefonnummern und Notizen der Gäste kommen dann leer zurück. Anfragen nach Gästedetails oder Online-Check-in-Daten werden mit 403 Forbidden abgelehnt. Erlaube auf der Seite API-Schlüssel Gästedaten für diesen Schlüssel. Oder erstelle einen neuen Schlüssel, aktiviere dabei Zugriff auf personenbezogene Gästedaten erlauben und nutze ihn in deinem Tool. Termine, Preise, Unterkünfte und Zahlungen sind nicht betroffen.
Ein Partner-Tool bekommt deine Buchungsupdates, aber in Smoobu steht kein Webhook
Da ist nichts kaputt und du musst nichts reparieren. Registriert ein Marketplace-Partner einen Webhook für dich, speichert Smoobu ihn getrennt von deinen eigenen, und in dem Feld taucht er nicht auf. Deine eigenen Webhooks bleiben davon unberührt. Trennst du den Partner später, entfernt Smoobu dessen Webhooks für dich.
Meinem Server fehlen Webhooks
Smoobu sendet jeden Webhook nur einmal, ohne erneuten Versuch. Ein Update erreicht dein System nicht, wenn:
- dein Server nicht innerhalb von 60 Sekunden antwortet. Smoobu verwirft das Update.
- dein Server mit HTTP 400 antwortet. Dein Server hat die Daten abgelehnt, die Smoobu gesendet hat. Sieh in den Logs deines Servers nach, warum.
Nutze die API, um die Buchungen und Änderungen abzurufen, die dir möglicherweise entgangen sind. Um zu prüfen, was ankommt, trag eine temporäre Adresse von einem Dienst wie webhook.site in das Webhook-Feld ein, lege eine Testbuchung an und sieh dir an, was eingeht. Antwortet deine Adresse immer wieder mit Fehlern, schaltet Smoobu sie ab und schickt dir eine E-Mail (siehe den nächsten Abschnitt).
Ich habe eine E-Mail bekommen, dass meine Webhook-URL abgeschaltet wurde
Smoobu schaltet eine Webhook-Adresse ab, wenn sie immer wieder mit Fehlern antwortet, und schickt dir diese E-Mail. Solange sie abgeschaltet ist, bekommt die Adresse keine Updates von Smoobu.
- Prüfe das System hinter der Adresse: deinen eigenen Server oder das Tool, für das du sie eingetragen hast. Es muss erreichbar sein und die Updates ohne Fehler annehmen. Gehört die Adresse zu einem Tool, wende dich an die Firma dahinter.
- Trag auf der Seite API-Schlüssel dieselbe Adresse erneut in das Webhook-Feld ein und klicke auf Speichern.
Antwortet die Adresse weiter mit Fehlern, schaltet Smoobu sie wieder ab. Nutzt du die Adresse nicht mehr, musst du nichts tun.
Anfragen werden mit 429 blockiert
Deine Anfragen scheitern mit HTTP 429 und der Meldung „Requests limit exceeded“: Deine Integration sendet mehr Anfragen, als Smoobu erlaubt. Die Sperre bleibt bestehen, solange deine Integration weiter Anfragen sendet. So kommst du durch:
- Seltener anfragen. Verteile deine Anfragen über einen längeren Zeitraum.
- Pausieren, dann erneut versuchen. Bekommst du eine 429, warte, bevor du die nächste Anfrage sendest, statt es sofort erneut zu versuchen.
- Anfragen bündeln, wo es geht, statt viele kleine zu senden.
Das genaue Limit steht in der Entwicklerdokumentation (docs.smoobu.com).
Meine signierten Anfragen scheitern mit 401 Unauthorized
Meist liegt es an der Signatur oder am Timestamp. Weitere häufige Ursachen:
- Zeitabweichung: Deine Systemzeit weicht um mehr als 5 Minuten ab. Stelle sicher, dass dein Server NTP nutzt.
- Wiederverwendete Nonce: Jede Anfrage muss eine eindeutige X-Nonce haben (nutze UUID v4 oder zufällige Bytes).
- Falscher Body-Hash: Bei GET- und DELETE-Anfragen hashst du einen leeren String, nicht null oder undefined.
- Reihenfolge der Query-Parameter: Sortiere die Parameter alphabetisch, wenn du den kanonischen String bildest.
- Abweichende Kodierung: Signiere den rohen JSON-Body genau so, wie er gesendet wird, mit demselben Whitespace und derselben Kodierung.
In der Übergangszeit kannst du vorübergehend auf unsignierte Anfragen zurückgreifen, während du den Fehler behebst.
Verwandte Artikel
- Wie gruppiere ich eine Unterkunft und ihre Unterobjekte, damit sie nicht doppelt gebucht werden?
- Smoobu für mehrere Unterkünfte, Teams und Konten
Kommst du nicht weiter?
Wenn diese Schritte das Problem nicht gelöst haben, kontaktiere das Smoobu-Team: Öffne das Menü Hilfe, um ein Ticket zu eröffnen oder einen Telefontermin zu buchen, oder nutze die Chat-Blase unten rechts. Für die schnellste Antwort gib bitte an:
- Deine Smoobu User ID (im Profil-Icon-Menü oben rechts).
- Den Namen oder die ID der Unterkunft, wenn es um eine bestimmte Unterkunft geht.
- Die Buchungs-ID, wenn es um eine bestimmte Buchung geht (Buchungen, dann Mehr anzeigen).
- Den Namen des Portals, wenn es um Portal-Sync geht (Booking.com, Airbnb, Vrbo und so weiter).
- Eine kurze Schritt-für-Schritt-Beschreibung: was du getan hast, was du erwartet hast und was passiert ist.
- Screenshots oder eine kurze Bildschirmaufnahme des Problems.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.