Personal Access Token (API-Schlüssel)
Woher du deinen meetergo API-Key bekommst: Erstelle einen Personal Access Token, um meetergo Log, einen Telefonassistenten oder deine eigene Anwendung mit der meetergo-API zu verbinden. Die Apps von Zapier und Make melden sich stattdessen mit deinem Konto an.
meetergo ermöglicht es dir, einfach einen persönlichen Zugriffstoken zu generieren, den du zur Authentifizierung mit der meetergo-API verwenden kannst.
Wenn ein Tool nach einem "meetergo API-Key", "API-Token" oder "API-Schlüssel" fragt, ist fast immer genau das gemeint. Personal Access Token ist der Name, den meetergo dafür verwendet.
Persönliche Zugriffstoken sind in jedem Tarif verfügbar, auch im kostenlosen.
Dein persönlicher Zugriffstoken sollte nicht mit Personen außerhalb deiner Organisation geteilt werden.
Welchen Zugang brauche ich?
meetergo hat zwei verschiedene Zugangsdaten, und nur eine davon erstellst du auf der Integrationen-Seite. Nimm die Zeile, die auf dich zutrifft:
| Du möchtest... | Nimm | Wo |
|---|---|---|
| Ein Tool mit deinem eigenen meetergo-Konto verbinden (meetergo Log, einen Telefon- bzw. KI-Assistenten wie Placetel oder IONOS, ein Skript, einen Schritt Webhooks by Zapier oder HTTP, der die meetergo-API aufruft) | Personal Access Token — dieser Artikel | Integrationen & Apps |
| Ein Produkt auf Basis von meetergo bauen, das Konten anderer Nutzer anlegt und verwaltet | Platform API-Key (ak_live:...) | Admin → API, benötigt einen separaten API-Platform-Tarif |
Die offiziellen Apps von Zapier und Make nehmen überhaupt keinen Token entgegen. Du verbindest sie, indem du dich in Zapier oder Make mit deinem meetergo-Konto anmeldest, siehe Zapier und Make mit meetergo verbinden. Ein Personal Access Token kommt erst ins Spiel, wenn du von dort aus die meetergo-API selbst aufrufst.
Wenn du meetergo-Kunde bist und eines deiner eigenen Tools anbindest, brauchst du einen Personal Access Token. Ein Platform API-Key funktioniert dafür nicht: Er gilt für das gesamte Unternehmen, benötigt bei jeder Anfrage zusätzlich den Header x-meetergo-api-user-id und ist nur im API-Platform-Tarif enthalten. Falls du die Platform API tatsächlich brauchst, findest du die Details in der API-Dokumentation.
Persönlichen Zugriffstoken erstellen
Befolge diese Schritte, um einen persönlichen Zugriffstoken zu erstellen und ihn mit unserer API zu verwenden:
- Melde dich bei deinem meetergo-Konto an und navigiere zu Integrationen & Apps
- Finde den Bereich "Persönliche Zugriffstoken"
- Klicke auf "Token erstellen", um einen neuen Zugriffstoken zu generieren
Um deinen Token zu erstellen, musst du ihm einen eindeutigen Namen geben. Du kannst optional ein Ablaufdatum festlegen.
Stelle sicher, den Token an einem sicheren Ort zu kopieren, da er nach der Erstellung nicht erneut angezeigt werden kann.
Verwendung
Um auf geschützte Ressourcen zuzugreifen, muss dein persönlicher Zugriffstoken (im vorherigen Schritt kopiert) als Bearer-Token im Authorization-Header deiner Anfrage angegeben werden.
Beispiel-Header:
Authorization: Bearer dein_token_hier
Weitere detaillierte Anweisungen zur Verwendung der API-Endpunkte findest du in unserer API-Dokumentation.
Worauf der Token zugreifen kann
Ein Personal Access Token handelt in deinem Namen. API-Aufrufe verhalten sich genau wie Aktionen, die du selbst im meetergo-Dashboard ausführst, mit deiner Rolle und deinen Berechtigungen:
- Als reguläres Mitglied kann der Token deine eigenen Terminseiten, Verfügbarkeiten und Buchungen verwalten.
- Als Admin kann der Token zusätzlich Daten im gesamten Workspace lesen und verwalten, zum Beispiel Benutzer auflisten oder die Termine anderer Benutzer abrufen.
Der Token kann keine Benutzer erstellen, aktualisieren oder löschen und nicht im Namen anderer Benutzer handeln. Diese Funktionen erfordern die meetergo API Platform. Details findest du in der Entwickler-Dokumentation.
Wird der Besitzer des Tokens aus dem Workspace entfernt, funktioniert der Token nicht mehr. Erstelle den Token für wichtige Integrationen deshalb über ein gemeinsames Admin-Konto (zum Beispiel integrations@deinefirma.de).
Sicherheit
Aus Sicherheitsgründen wird der Token nicht auf unseren Servern gespeichert. Das bedeutet, dass du deinen Token nach der Ausstellung nicht mehr einsehen kannst.
Darüber hinaus empfehlen wir, ein Ablaufdatum für deine Tokens festzulegen. Nach Ablauf des Tokens kann er nicht mehr zur Authentifizierung bei der API verwendet werden.
Wenn du einen deiner Tokens widerrufen möchtest, kannst du dies mit der Schaltfläche "Widerrufen" neben dem Token tun. Sobald du einen Token widerrufen hast, kann er nicht mehr zur Authentifizierung bei der API verwendet werden.
Verwandte Artikel
War dieser Artikel hilfreich?
Lass uns wissen, ob dieser Artikel deine Fragen beantwortet hat.