Request an invite
Appointer API · v1Beta

Erstellen Sie Integrationen mit Appointer.

Eine REST-API und signierte Webhooks für alles in Ihrem Konto – Termine, Kunden, Dienstleistungen, Mitarbeiter und Standorte. Lesen, schreiben und reagieren Sie in Echtzeit.

Schlüssel werden unter Einstellungen → Entwickler ausgestellt · auf den Workspace beschränkt · einmalig angezeigt
The API is in Beta. Endpoints are stable and safe to build on — we'll give advance notice before any breaking change.
Idempotency built in
Real-time webhooks
$ curl https://api.appointer.co/v1/appointments \
     -H "Authorization: Bearer ak_live_…"
     -H "Accept: application/json" ▋
Basis-URL
api.appointer.co/v1
Ein Host, alle Endpunkte
Transport
TLS 1.2+
HTTPS bei jedem Aufruf erforderlich
Versionierung
v1 · stabil
Breaking Changes erhalten eine neue Version
Ratenbegrenzung
10,000 / hr
Pro Workspace · 429 mit Retry-After
Authentifizierung

Bearer-Schlüssel, auf einen Workspace beschränkt.

Authentifizieren Sie jede Anfrage mit einem geheimen API-Schlüssel im Authorization-Header. Erstellen Sie einen unter Einstellungen → Entwickler – er kann nur Daten innerhalb dieses Workspace lesen und schreiben.

Auf den Workspace beschränkt. Ein Schlüssel reicht nie über den Workspace hinaus, der ihn ausgestellt hat.
Einmalig angezeigt. Das vollständige Geheimnis erscheint ein einziges Mal, bei der Erstellung. Speichern Sie es serverseitig.
Widerrufbar. Erneuern oder widerrufen Sie einen Schlüssel sofort – alte Schlüssel geben umgehend 401 zurück.
request headers
# jede Anfrage trägt ein auf den Workspace beschränktes Bearer-Token
Authorization: Bearer ak_live_AbCd3f9K2mQ7xR1pN8sV4tZ6wY0jL5hT
Verwenden Sie einen geheimen Schlüssel niemals in clientseitigem Code oder einem öffentlichen Repository. Nutzen Sie für Browser-Kontexte das einbettbare Buchungs-Widget.
Was Sie erstellen können

Von einem Kalender zu einer ganzen Plattform.

Die API stellt dieselben Entitäten bereit, mit denen Sie täglich arbeiten – Termine, Kunden, Dienstleistungen, Mitarbeiter und Standorte.

Individuelles Buchungs-Widget

Rufen Sie Live-Verfügbarkeit ab und erstellen Sie Termine direkt von Ihrer eigenen Website oder App.

CRM-Synchronisierung

Spiegeln Sie Kunden und ihren vollständigen Terminverlauf in HubSpot, Salesforce oder Ihr eigenes CRM.

Analytics- & BI-Export

Streamen Sie Termine, Umsätze und Nichterscheinen in Ihr Data Warehouse, Looker oder eine Finanztabelle.

Individuelle Benachrichtigungen

Reagieren Sie auf Webhooks, um eigene SMS, Slack-Benachrichtigungen oder Nachfass-Aktionen nach dem Besuch auszulösen.

Buchung per KI-Assistent

Lassen Sie einen Assistenten freie Zeitfenster auslesen und im Namen eines Kunden buchen und dann per Chat bestätigen.

Standortübergreifende Abläufe

Verwalten Sie die Arbeitszeiten von Mitarbeitern und führen Sie die Kalender mehrerer Standorte in einem Dashboard zusammen.

Webhooks

In Echtzeit und signiert.

Registrieren Sie einen Endpunkt, und Appointer sendet per POST einen JSON-Payload in dem Moment, in dem ein Ereignis ausgelöst wird. Jede Zustellung wird mit einem Geheimnis pro Endpunkt im Header X-Appointer-Signature signiert – berechnen Sie den HMAC-SHA256 des rohen Bodys neu und vergleichen Sie ihn in konstanter Zeit, um zu bestätigen, dass sie von uns stammt.

Ereignis
Wann es ausgelöst wird
appointment.created
Eine Buchung wird über einen beliebigen Kanal erstellt – Seite, Embed oder Admin.
appointment.cancelled
Ein Kunde oder Mitarbeiter storniert eine Buchung.
appointment.rescheduled
Eine bestehende Buchung wird auf eine neue Uhrzeit oder einen anderen Mitarbeiter verschoben.
appointment.completed
Ein Termin wird als abgeschlossen markiert und ausgecheckt.
appointment.no_show
Ein Kunde erscheint nicht und das Zeitfenster wird gekennzeichnet.
Vollständige Referenz

Jeder Endpunkt, dokumentiert.

Durchsuchen Sie die vollständige OpenAPI-Referenz – Request- und Response-Schemata, Fehlercodes, Paginierung und Idempotenz sowie den vollständigen Webhook-Ereigniskatalog.