per Webhook · Perfect Gym Open API
Perfect Gym mit meiti verbinden
meiti verbindet sich mit Perfect Gym über einen Webhook, der auf die offene API der Plattform trifft. meiti nimmt Anrufe, WhatsApp- und Webanfragen rund um die Uhr an, versteht das Anliegen und gibt es weiter. Eine Automation legt Interessenten direkt als Lead in Perfect Gym an oder bucht den passenden Termin, Probetraining oder Kursplatz. Kein Zettel an der Rezeption, keine doppelte Erfassung am nächsten Morgen.
Aktualisiert am 30. Juli 2026
Was ist das?
Perfect Gym (auch Perfect Gym Next) ist eine cloudbasierte Verwaltungssoftware für Fitnessstudios, Studioketten und Freizeiteinrichtungen: Mitgliederverwaltung, Vertragswesen, Kurs- und Terminbuchung, Zutrittskontrolle und Reporting über mehrere Standorte aus einer Plattform. Zu den Referenzkunden zählen unter anderem Crunch, Everlast, Fit4Less und MAC (Quelle: perfectgym.com, 30.07.2026). Perfect Gym gehört zur Sport-Alliance-Unternehmensgruppe, zu der auch die in Deutschland verbreitete Studiosoftware Magicline zählt, erkennbar an der gemeinsamen Entwicklerplattform developer.sportalliance.com (Quelle: developer.sportalliance.com, 30.07.2026). Die Plattform bietet eine offene REST-API (Open API) mit dokumentierten Endpoints für Kunden, Leads, Kurse und Terminbuchung.
So verbindest du es mit meiti
Vorab: meiti gibt Ereignisse aus jedem Anruf, jedem Chat und jeder Web-Anfrage per Webhook weiter. Eine Automation (zum Beispiel in n8n) nimmt dieses Ereignis entgegen und ruft die Perfect Gym Open API auf, um daraus einen Lead, einen Kontakt oder einen gebuchten Termin zu machen.
Voraussetzungen
aktiver Perfect-Gym-Account mit freigeschaltetem Open-API-Zugang
aktiver meiti-Account
eine Automations-Instanz (n8n oder vergleichbar) als Bindeglied
Open-API-Zugang bei Perfect Gym anfragen. Die Freischaltung wird vom Studio-Betreiber ausgelöst. Nach Freigabe erhält das Studio zwei API-Keys, einen für eingehende Requests, einen für Webhook-Events, sowie die studio-eigene Basis-URL nach dem Muster
https://<tenant>.open-api.perfectgym.com/v1.Webhook in meiti einrichten. Einstellungen → Unternehmen → CRM-Synchronisation → Webhook. Ziel-URL deiner Automation eintragen, optional ein Bearer-Token für die Authentifizierung setzen.
Auslöser festlegen. meiti kennt fünf Ereignisse:
IncomingCallLookup,FinishedCall,NewConversation,ConversationPaused,Manual. Für die Studioanbindung eignen sich vor allemFinishedCall(abgeschlossenes Telefonat) undNewConversation(WhatsApp oder Webchat).Automation bauen. Die Automation empfängt
contactDataundprojectDataaus dem meiti-Webhook, prüft perPOST /v1/customers/search, ob die Person bereits Mitglied ist, legt neue Interessenten überPOST /v1/leads/createals Lead an und bucht bei einem konkreten Terminwunsch überPOST /v1/appointments/booking/bookoderPOST /v1/classes/booking/book, jeweils mit demx-api-keyim Header.Rückmeldung einbauen. Die Automation antwortet über die
callbackUrlaus dem meiti-Webhook-Payload, die fünf Minuten gültig und nur einmal nutzbar ist, damit der Vorgang im meiti-Postfach als erledigt markiert wird.Testen. Testereignis über den Webhook-Trigger-Button in den Projektdetails auslösen, Ergebnis in Perfect Gym prüfen.
Live schalten.
Die Ersteinrichtung der Automation läuft am schnellsten gemeinsam mit dem meiti-Team.
Was dann möglich ist
Verpasster Anruf wird Lead. Ein Interessent ruft um 20:14 Uhr an, meiti nimmt ab, fragt nach Ziel und Wunschzeit, ein neuer Lead landet über
/v1/leads/createmit Gesprächszusammenfassung in Perfect Gym.Bestehendes Mitglied bucht direkt. Ein Mitglied ruft wegen eines PT-Termins an, die Automation findet die Person über
/v1/customers/searchund bucht den Termin sofort über/v1/appointments/booking/book.Kursanfrage per WhatsApp. „Habt ihr noch Plätze im Yoga-Kurs Dienstag 18 Uhr?“ meiti klärt den Wunsch, die Automation prüft freie Plätze und bucht über
/v1/classes/booking/book.Web-Anfrage außerhalb der Öffnungszeiten. Eine Anfrage über den Webchat um 23 Uhr wird als Lead angelegt und liegt am nächsten Morgen direkt im Vertriebs-Workflow des Studios.
Follow-up nach dem Anruf. meiti schickt im Anschluss automatisch eine WhatsApp-Bestätigung oder einen Buchungslink, während Lead beziehungsweise Termin parallel in Perfect Gym stehen.
Voraussetzungen und Grenzen
Open-API-Zugang bei Perfect Gym, freigeschaltet durch den Studio-Betreiber; Standard-Rate-Limit 1000 Requests pro Minute.
Eine Automations-Instanz (n8n oder vergleichbar), die den meiti-Webhook mit der Perfect Gym Open API verbindet; Ersteinrichtung idealerweise mit dem meiti-Team.
Der Webhook-Weg ist ab dem meiti SCALE-Plan enthalten, kein Aufpreis pro Tool.
Tiefere Studio-Funktionen wie Vertragsabschluss, Zahlungen und Zutrittskontrolle bleiben in Perfect Gym; meiti legt Leads und Termine an, verwaltet aber keine Mitgliedschaften oder Abrechnungen.
Die genauen Feldnamen für den Lead-Request-Body sind in der öffentlichen Doku nicht bis ins letzte Detail aufgeführt; das Feld-Mapping wird bei der Ersteinrichtung der Automation konkretisiert.
Häufige Fragen
Was braucht mein Studio, um Perfect Gym anzubinden?
Einen freigeschalteten Open-API-Zugang bei Perfect Gym und eine Automation, die den meiti-Webhook mit der Perfect-Gym-API verbindet.
Wer richtet die Verbindung ein?
Der Webhook wird in den meiti-Einstellungen eingerichtet; für die Automation gegen die Perfect-Gym-API unterstützt das meiti-Team.
Landen wirklich alle Anrufe als Lead?
Nur die, die du im Setup dafür auswählst, etwa abgeschlossene Anrufe oder neue Chats. Du legst die Auslöser fest.
Bucht meiti auch Probetrainings oder Kurse direkt?
Ja, sobald die Automation eingerichtet ist, prüft sie freie Plätze über die Perfect-Gym-API und bucht den Termin.
Was passiert mit meinen Daten?
Kontakt- und Gesprächsdaten werden per Webhook übertragen, optional per Bearer-Token abgesichert. meiti ist DSGVO-konform, Server in Frankfurt.
Was kostet das?
Der Webhook-Weg ist ab dem meiti SCALE-Plan enthalten, kein Aufpreis pro Tool.
So passt meiti dazu
meiti nimmt Anrufe, WhatsApp- und Webanfragen rund um die Uhr an, in unter einer Sekunde, egal ob an der Rezeption gerade Unternehmen ist oder das Studio geschlossen hat. Über den Webhook geht jede Anfrage direkt dorthin weiter, wo dein Team im Studio arbeitet: in Perfect Gym. Kein Interessent geht verloren, weil er nach Feierabend angerufen hat. Über 4000 Unternehmen nutzen meiti bereits, und meiti wird mit jedem Anruf besser.
Weiterführend
Quellen
developer.sportalliance.com/apis/perfectgym/openapi/general-information, 30.07.2026 (Authentifizierung, Aktivierung durch Studio-Betreiber, zwei API-Keys, Base-URL-Muster, Rate-Limit 1000/min, Webhook-Unterstützung).
developer.sportalliance.com/apis/perfectgym/openapi/openapi, 30.07.2026 (Endpoints: /v1/customers, /v1/customers/search, /v1/leads/create, /v1/appointments/booking/book, /v1/classes/booking/book).
perfectgym.com, 30.07.2026 (Was ist Perfect Gym, Zielgruppe, Referenzkunden Crunch/Everlast/Fit4Less/MAC).
meiti.app/docs/webhook, 30.07.2026 (meiti-Webhook-Setup, Menüpfad, Events, Payload-Struktur, Callback-URL).
Bereit, keinen Anruf mehr zu verpassen?
CRM-Anbindung, Webhooks & API sind ab dem meiti Team-Tarif enthalten, MCP-Zugang ab dem Unternehmen-Tarif, kein Aufpreis pro Tool.