YOGO API

Deine Daten.
In deiner Sprache.

Der YOGO MCP-Server verbindet dein Studio direkt mit ChatGPT und Claude im Browser, dazu Claude Desktop, Claude Code und Gemini. Frag in natürlicher Sprache, bekomm die Antwort in Sekunden. Oder nutze die REST-API darunter, um eigene Integrationen mit CRM, BI-Stack oder Mitarbeiter-App zu bauen.

Zur Dokumentation Zugang anfragen

REST & JSON MCP-ready In der EU gehostet

first-call.sh

MCP cURL JavaScript

# Gefragt in Claude mit YOGO MCP
> Wie viele Kunden haben sich letzten
  Monat angemeldet?

# Claude ruft das MCP-Tool auf:
list_customers(auto_paginate: true)

< 147 neue Kunden im April, 23% mehr
  als im März. Soll ich es aufschlüsseln?

# Ein erster Aufruf: hol deine Kunden
curl https://api.yogobooking.com/customers \
  -H "X-API-KEY: your_api_key_here"

// Ein erster Aufruf: hol deine Kunden
const res = await fetch(
  'https://api.yogobooking.com/customers',
  { headers: { 'X-API-KEY': process.env.YOGO_KEY } }
);

const { data, hasMore, next } = await res.json();

Konkrete Integrationen

Beispiele, die du diese Woche bauen kannst.

Keine Theorie. Genau dafür ist die YOGO API gemacht. Jede Integration kostet ein Dev-Team ein paar Tage und spart dir Handarbeit, solange das Studio läuft.

Dienstplanung

Kurse als Schichten zu Planday, Tamigo oder Sameworks synchronisieren.

Hol den Kursplan aus YOGO und lege Schichten automatisch in deinem Dienstplan-System an. Trainer sehen ihre YOGO-Kurse als echte Schichten neben dem restlichen Team, und der Lohn-Export passt zu dem, was tatsächlich unterrichtet wurde.

GET /classes GET /teachers nightly sync

// Täglich: Schichten in Planday anlegen
const classes = await paginate(
  `${YOGO}/classes?from=today&to=+14d`
);

for (const c of classes) {
  for (const teacherId of c.teacherIds) {
    await planday.shifts.create({
      employeeId: mapTeacher(teacherId),
      departmentId: DEPT,
      startDateTime: c.startsAt,
      endDateTime: c.endsAt
    });
  }
}

Trainerwechsel in Claude

Trainer aus dem Chat umbuchen, ohne das Admin-Modul zu öffnen.

Frag Claude in natürlicher Sprache. Claude findet Kurs und Trainer über list_classes und list_teachers und führt dann set_class_teachers aus. Jeder Schreibvorgang landet im Audit-Log und lässt sich über list_write_logs abrufen.

list_classes list_teachers set_class_teachers list_write_logs

# Beispiel-Prompt in Claude Desktop
> Setz Mette auf Vinyasa Donnerstag 07:00.

# Claude findet Kurs und Trainer:
list_classes({ from: "2026-05-14", to: "2026-05-14" })
list_teachers({ search: "Mette" })

# Schreibt die Änderung:
set_class_teachers({
  classId: 12345,
  teacherIds: [678]
})

# Audit-log:
list_write_logs({ entityType: "class.teachers" })

CRM & E-Mail

Mitglieder nach HubSpot, Mailchimp oder Klaviyo synchronisieren.

Lass nachts einen Job laufen, der alle Kunden samt Buchungshistorie zieht und in deine Marketing-Plattform schiebt. Segmentiere nach echtem Verhalten, also aktiv, abgesprungen oder neu angemeldet, und verschicke passende Kampagnen.

GET /customers GET /bookings cursor pagination

# Nachts: Kunden zu Mailchimp synchronisieren
let cursor;
do {
  const res = await fetch(
    `${YOGO}/customers?after=${cursor || ''}`,
    { headers: { 'X-API-KEY': KEY } }
  ).then(r => r.json());

  await mailchimp.lists.batchSubscribe(
    LIST_ID,
    res.data.map(toMailchimpMember)
  );

  cursor = res.hasMore ? extractAfter(res.next) : null;
} while (cursor);

BI & Reporting

Live-Dashboards in Power BI oder Looker Studio.

Zieh Buchungen und Kursdaten in deinen BI-Stack, kombiniert mit Finanzdaten aus der Buchhaltung, Fitnessdaten aus Strava oder was du sonst nutzt. Endlich ein Management-Report, der alles abdeckt.

GET /classes GET /bookings GET /customers

# Daily ETL → Power BI dataset
const bookings = await paginate(
  `${YOGO}/bookings?from=${yesterday}`
);

// Buchungen + Kurs-Expansion (benötigt expand=class)
const bookings = await paginate(
  `${YOGO}/bookings?from=yesterday&to=today&expand=class`
);

const rows = bookings.map(b => ({
  date: b.class.startsAt,
  className: b.class.className,
  status: b.cancelledAt ? 'cancelled'
        : b.checkedInAt ? 'checked-in'
        : 'booked',
  customerId: b.customerId
}));

await powerbi.pushRows(DATASET, rows);

Mitarbeiter-App

Trainer und Kurse in deine gebrandete Mitarbeiter-App pushen.

Synchronisiere Kursplan und Trainer-Stammdaten in deine Mitarbeiter-App, zum Beispiel Monotree, damit das Team die Schichten des Tages, Kontaktdaten und Kursinfos in der Tasche hat, zusammen mit Onboarding und interner Kommunikation. Eine App, eine Datenquelle.

GET /classes GET /teachers nightly sync

// Täglicher Push zu Monotree
const classes = await paginate(
  `${YOGO}/classes?from=today&to=+14d&expand=classType,room`
);

const shifts = classes.map(c => ({
  date: c.startsAt,
  title: c.classType.name,
  teacherIds: c.teacherIds,
  room: c.room.name
}));

await monotree.shifts.upsert(shifts);

Inspiration · Open source

Kristian hat eine sGTM-Integration gebaut und open-source gestellt.

Kristian Krogh Bang hat eine Open-Source-Pipeline gebaut, die /orders, /bookings und /customers alle 60 Sekunden abfragt und die Daten an serverseitiges GTM weitergibt, von dort an GA4, Meta CAPI, Klaviyo oder was du sonst nutzt. Das gesamte Projekt steht unter Apache 2.0 auf GitHub. Eine gute Referenz, wenn du etwas Ähnliches bauen willst.

GitHub Zum Blogpost LinkedIn

KI-ready · MCP

Das ganze Studio.
In einem Chat.

Der YOGO MCP-Server läuft auf mcp.yogobooking.com/mcp und stellt jeden REST-Endpoint als MCP-Tool bereit. Mit OAuth verbindest du ihn direkt in ChatGPT und Claude im Browser, oder du nutzt deinen API-Key in Claude Desktop, Claude Code und Gemini. Gleiche Auth, gleiches Audit-Log. Kein Glue-Code, keine Server für dich.

Demo

Ask your member management system anything.

Frag nach Mitgliederzahlen, tausche einen Trainer, baue ein Dashboard. Alles im Chat, mit deinen eigenen Daten.

Demo ansehen 45 Sek.

Neu: Verbinden per OAuth und eine erste Frage in natürlicher Sprache. Keine Keys in der Zwischenablage, keine Config-Dateien.

yogo-mcp · verbunden

Welche Kurse stehen nächste Woche im Plan?

Claude

Ich schaue in den Kursplan.

tool_calllist_classes(from: "2026-05-11", expand: "teachers")

Claude

Du hast nächste Woche 24 Kurse. Vinyasa Donnerstag 07:00 hat keinen Trainer. Soll ich Mette darauf setzen?

Das ganze Studio als Tools

Kunden, Trainer, Bestellungen, Buchungen und Kurse. Jeder REST-Endpoint ist als MCP-Tool verfügbar, inklusive set_class_teachers, um Trainer direkt aus dem Chat umzubuchen.

Gleicher API-Key, gleiche Regeln

Der MCP-Server nutzt deinen bestehenden API-Key als Bearer-Token. Gleiches Plan-Gating und gleiches Audit-Log über list_write_logs.

In 5 Minuten verbunden

ChatGPT, Claude im Browser, Claude Desktop, Claude Code und Gemini werden unterstützt. Im Browser meldest du dich per OAuth an, auf dem Desktop nutzt du den API-Key. Kein Code nötig.

Wichtig: Nutze beim KI-Anbieter ein Geschäftskonto mit Auftragsverarbeitungsvertrag. Bei privaten Konten kannst du das Training in den Einstellungen abschalten, bekommst aber trotzdem nicht den Auftragsverarbeitungsvertrag, den die DSGVO verlangt. Was zur DSGVO gilt.

Preis

Ein Festpreis. Alles enthalten.

Der API-Zugang ist ein Add-on zu den Paketen Studio und Studio+App.

€79 / Monat

Erfordert einen aktiven Studio- oder Studio+App-Plan.

Komplette, öffentliche Dokumentation
Zugang zu allen bestehenden Endpoints
Neue Endpoints, sobald sie kommen, ohne Aufpreis
In der EU gehostet, DSGVO-konform

Das Kleingedruckte

Wir stellen eine ausführliche API-Dokumentation bereit, unterstützen aber nicht bei der Integrationsarbeit selbst. Du brauchst also eigene Kapazität, um deine Integration zu bauen und zu pflegen. Die API selbst pflegen und aktualisieren wir natürlich laufend. Bei Fragen zur Funktionsweise kannst du dich gerne melden.

Bindest du einen KI-Dienst über MCP an, werden die Daten bei diesem Anbieter verarbeitet, nicht bei YOGO. Nutze ein Geschäftskonto mit Auftragsverarbeitungsvertrag, nenne den Anbieter in deiner Datenschutzerklärung und prüfe die Antworten der KI, bevor du bei etwas Wesentlichem danach handelst.

Fragen & Antworten

Das werden wir am häufigsten gefragt.

Was ist die YOGO API?

Die YOGO API ist die offizielle REST-API der YOGO Booking-Plattform. Yogastudios, Fitnessstudios und Wellness-Betriebe holen damit ihre eigenen Daten heraus, also Kunden, Bestellungen, Buchungen, Kurse und Trainer, und bauen Integrationen mit CRM, E-Mail-Marketing, BI-Stack, Dienstplanung und Mitarbeiter-Apps.

Was kostet die YOGO API?

Der API-Zugang kostet 79 € pro Monat als Add-on zu den Paketen YOGO Studio und Studio+App. Enthalten sind alle bestehenden Endpoints, der MCP-Server und alle künftigen Endpoints ohne Aufpreis. Die komplette öffentliche Dokumentation ist kostenlos unter docs.api.yogobooking.com verfügbar.

Was ist der YOGO MCP-Server?

Der YOGO MCP-Server ist ein Model Context Protocol-Server, der YOGOs REST-Endpoints als Tools direkt in ChatGPT, Claude im Browser, Claude Desktop, Claude Code und Gemini bereitstellt. Er läuft auf mcp.yogobooking.com/mcp und nutzt dasselbe Audit-Log wie die REST-API. Im Browser verbindest du dich per OAuth, auf dem Desktop mit deinem API-Key als Bearer-Token. Die Verbindung dauert fünf Minuten und braucht keinen Code.

Unterstützt YOGO MCP OAuth?

Ja. Du kannst YOGO jetzt direkt in ChatGPT und Claude im Browser verbinden, ohne API-Keys hin und her zu kopieren oder Config-Dateien zu bearbeiten.

Du fügst mcp.yogobooking.com/mcp als MCP-Connector hinzu, wirst zu YOGO weitergeleitet, meldest dich mit deinem eigenen Konto an und bestätigst den Zugriff. Danach kannst du in natürlicher Sprache fragen.

Clients wie Claude Desktop, Claude Code und Gemini nutzen weiterhin einen API-Key als Bearer-Token. Beide Wege treffen dieselben Endpoints und dasselbe Audit-Log.

Welche Integrationen kann ich mit der YOGO API bauen?

Typische Integrationen sind: Kundendaten ins CRM synchronisieren (HubSpot, Klaviyo, Mailchimp), Live-Dashboards in BI-Tools (Power BI, Looker Studio, BigQuery), Dienstplanung, in der Trainer als Schichten erscheinen (Planday, Tamigo, Sameworks), gebrandete Mitarbeiter-Apps mit den Kursen des Tages (zum Beispiel Monotree), eigene Buchungs-Widgets auf deiner Website (Squarespace, Webflow, Next.js) und serverseitiges Analytics-Tracking (sGTM → GA4, Meta CAPI). Eine Standard-Integration baut ein Entwickler meist in wenigen Tagen.

Unterstützt YOGO bei der Integration selbst?

Nein. Wir stellen eine ausführliche API-Dokumentation bereit, unterstützen aber nicht bei der Integrationsarbeit selbst. Du brauchst also eigene Kapazität, um deine Integration zu bauen und zu pflegen, oder einen externen Entwickler. Die API selbst pflegen und aktualisieren wir natürlich laufend, und bei Fragen zur Funktionsweise kannst du dich jederzeit melden.

Welche YOGO-Pakete haben API-Zugang?

Der API-Zugang ist als Add-on zu den Paketen YOGO Studio und Studio+App verfügbar. Du brauchst also einen aktiven Studio- oder Studio+App-Plan und aktivierst danach den API-Zugang für 79 € pro Monat.

Ist die YOGO API DSGVO-konform?

Ja, auf Seiten von YOGO. Die YOGO API und der MCP-Server laufen in der EU (AWS Frankfurt), und die Nutzung ist über den Auftragsverarbeitungsvertrag abgedeckt, den du bereits mit YOGO hast.

Wichtig: Der KI-Dienst, den du selbst anbindest (zum Beispiel Claude, ChatGPT oder Gemini), ist dein eigener Auftragsverarbeiter, nicht der von YOGO. Daten, die die KI über die API abruft, werden bei diesem Anbieter verarbeitet, in der Regel in den USA.

Das ist zulässig, wenn du ein Geschäftskonto (Team/Business, Enterprise oder API) mit Auftragsverarbeitungsvertrag nutzt. Der Vertrag stützt sich auf die EU-Standardvertragsklauseln, bei Google auf das EU-US Data Privacy Framework, was die Übermittlung in die USA rechtmäßig macht.

Ein privates Konto, auch ein bezahltes wie ChatGPT Plus oder Claude Pro, hat keinen Auftragsverarbeitungsvertrag. Du kannst das Training mit deinen Daten in den Einstellungen abschalten, und das solltest du auch, aber es löst das Problem nicht: Ohne Auftragsverarbeitungsvertrag fehlt dir weiterhin die Rechtsgrundlage, die Artikel 28 DSGVO verlangt, wenn ein Anbieter personenbezogene Daten in deinem Auftrag verarbeitet. Nenne den KI-Anbieter außerdem in deiner Datenschutzerklärung.

Kann ich sehen, was die KI gemacht hat, und den Zugriff wieder sperren?

Ja. Jede Änderung über die API wird protokolliert, du siehst also, was wann geändert wurde.

Den API-Key erstellst du im YOGO Admin unter Einstellungen und kannst ihn jederzeit deaktivieren. Nutzt du OAuth, lässt sich der Zugriff an derselben Stelle widerrufen, ohne deine übrigen Integrationen zu beeinträchtigen.

Das Audit-Log lässt sich außerdem programmatisch über list_write_logs abrufen und in dein eigenes Monitoring einspeisen.

Welches Konto sollten wir beim KI-Anbieter nutzen?

Ein Geschäftskonto mit Auftragsverarbeitungsvertrag. Private Konten sind für Kundendaten nicht geeignet, auch nicht die bezahlten, und auch nicht mit abgeschaltetem Training.

Claude: Team, Enterprise oder API-Zugang über Anthropic.
ChatGPT: Business, Enterprise oder API-Zugang über OpenAI.
Gemini: Google Workspace oder Google Cloud (Vertex AI).

Prüfe immer die Bedingungen und die Datenschutzerklärung des Anbieters. Sie bestimmen, wie deine Daten behandelt werden, sobald sie YOGO verlassen.

Training abzuschalten ist unabhängig vom Kontotyp sinnvoll, ersetzt aber keinen Auftragsverarbeitungsvertrag. Beides löst ein anderes Problem.

Wer haftet für die Antworten der KI?

Die Antworten der KI werden nicht von YOGO erzeugt. Prüfe alles Wesentliche, bevor du danach handelst.

YOGO liefert die Daten über die API. Deutung, Zusammenfassung und Schlussfolgerung kommen vom KI-Dienst, und der kann sich irren. Nutze es als Arbeitswerkzeug, nicht als geprüften Bericht.

Für Schreibvorgänge empfehlen wir, die Freigabe zu aktivieren, sodass ein Mensch die Änderung bestätigt, bevor sie gespeichert wird.

Wo läuft der YOGO MCP-Server?

In der EU, auf AWS Frankfurt (eu-central-1), am selben Ort wie der Rest von YOGO.

Der MCP-Server speichert deine Daten nicht. Er leitet Aufrufe an die REST-API von YOGO weiter und gibt die Antwort an den KI-Client zurück, den du freigegeben hast. Der gesamte Verkehr ist verschlüsselt, und der Zugriff ist an dein eigenes Konto gebunden, sodass die API nur Daten aus deinem eigenen Studio zeigt.

Bereit zu bauen?

Starte mit der Dokumentation.

Die vollständige, aktuelle Dokumentation ist öffentlich. Schreib uns, wenn du den API-Zugang für dein Konto aktivieren willst.

Dokumentation öffnen Zugang anfragen

Deine Daten. In deiner Sprache.