Integrations-API

Buchungen in deinem System. Der Kalender bleibt in Umovi.

Lies Leistungen aus, prüfe freie Zeiten und verwalte Buchungen aus deinem System. Der OAuth2-Zugriff umfasst die Daten einer Organisation.

Server-zu-Server-REST-API · OAuth2 Client Credentials · signierte Webhooks

Eine echte API-Transaktion

POST /reservations

201 Created

Request

{
  "serviceId":
    "2c4f3d1e-0e4a-4f9f-91cf-00c59a652f4a",
  "employeeId":
    "86c8a0ab-e419-4a13-bc8f-13112c9a2a45",
  "startAt": "2026-09-03T17:30:00+02:00",
  "client": { "phone": "+48…" },
  "source": "partner-crm"
}

Response

Reservation created

bookingId · confirmed · 17:30

Source saved

partner-crm · crm-1842

Was du anbinden kannst

Von der Leistungsauswahl bis zur Buchungsänderung.

Wähle die Vorgänge, die deine Integration braucht. Leistungen, Dienstpläne und Regeln verwaltest du weiter in deinem Umovi-Arbeitsbereich.

Leistungen, Personen und Suche

Lies Leistungen und die ausführenden Personen aus. Auch eine im Gespräch genannte Leistung lässt sich einem Katalogeintrag zuordnen.

catalog · search · resolve

Verfügbarkeit

Suche in einem Zeitraum oder frage den ersten passenden Termin für die gewählte Leistung und Person ab.

slots · first available

Kunden und Buchungen

Finde oder erstelle einen Kunden und lege dann eine Buchung an, rufe sie ab, aktualisiere, verschiebe oder storniere sie.

clients · reservations · history

Webhooks

Abonniere Buchungsereignisse, prüfe Zustellungen, versende einen Test und erneuere den Signaturschlüssel.

Signierte Zustellung · Test · Schlüsselwechsel

Nach der Anfrage

Dein System bleibt auf dem neuesten Stand.

Ein signierter Webhook informiert die Integration über Buchungsänderungen. Der Zustellverlauf macht Wiederholungen und betriebliche Prüfungen nachvollziehbar.

Signed booking events

booking.createdbooking.updatedbooking.cancelled

Signaturschlüssel beim Erstellen des Abonnements verfügbar

Zustellverlauf für jedes Abonnement

Integrierte Testzustellung und Schlüsselwechsel

API-Dokumentation und Tester

Starte in der Dokumentation, teste jeden Vorgang im Browser.

Die Dokumentation enthält den OpenAPI-Vertrag und einen API-Tester, der Anfragen direkt an die gewählte Umovi-API-Adresse sendet.