Ein Workout per API auf eine Garmin-Uhr schreiben
Anders als oft zu lesen ist, bietet Garmin sehr wohl eine offizielle API, die strukturierte Workouts in das Konto eines Nutzers schreiben kann. Es gibt sie, sie ist dokumentiert, und sie ist standardmäßig geschlossen. Hier steht, was sie genau ermöglicht und welche Alternativen es gibt, wenn man keinen Zugang hat.
Zuletzt aktualisiert: 2026-08-24
Drei Wege, und nur einer ist offiziell
Ein Workout auf eine Garmin-Uhr zu bringen, ohne es von Hand einzugeben, läuft immer auf einen dieser drei Ansätze hinaus. Sie sind nicht gleichwertig – weder bei der Zuverlässigkeit noch bei den Zugangsbedingungen.
| Weg | Was er erfordert | Zuverlässigkeit |
|---|---|---|
| Offizielle Training API | Eine Zulassung zum Garmin Developer Program. Der Nutzer erlaubt den Zugriff auf einer Garmin-Seite, ohne je sein Passwort herauszugeben. | Stabil: ein öffentlicher Vertrag, den Garmin pflegt. |
| FIT-Datei | Eine Binärdatei im FIT-Format erzeugen und sie dann per USB-Kabel in den Ordner der Uhr kopieren oder über eine Drittplattform übertragen. | Zuverlässig, aber manuell: keine automatische Synchronisierung. |
| Private Endpunkte von Garmin Connect | Benutzername und Passwort des Garmin-Kontos, gespeichert von dem Tool, das sie verwendet. | Wacklig: Diese Adressen sind nicht öffentlich und können sich ohne Vorwarnung ändern. |
Der dritte Weg ist in Community-Projekten mit Abstand am weitesten verbreitet, weil er keine Genehmigung erfordert. Er ist auch derjenige, der den Nutzer am stärksten gefährdet – und der an dem Tag ausfällt, an dem Garmin seine Website ändert.
Was die Training API wirklich ermöglicht
Die Training API von Garmin in Version 2 deckt zwei verschiedene Vorgänge ab, die man nicht verwechseln darf: ein Workout in der Bibliothek des Kontos erstellen und es auf ein Datum im Kalender legen. Ein erstelltes, aber nicht geplantes Workout bleibt verfügbar, erscheint aber nicht am gewünschten Tag.
Erstellen und planen
Beim Erstellen wird ein vollständiges strukturiertes Workout akzeptiert: eine Abfolge von Schritten der Typen Einlaufen, Belastung, Erholung, Auslaufen, mit verschachtelten Wiederholungsblöcken. Jeder Schritt hat eine Endbedingung und optional ein Ziel.
- Endbedingung: eine Dauer in Sekunden, eine Distanz in Metern oder ein offener Schritt, den der Athlet per Tastendruck beendet.
- Ziel: ein Tempo, ein Prozentsatz der maximalen Herzfrequenz, eine Leistung in Watt, eine Frequenz oder gar nichts.
- Wiederholungen: Ein Block lässt sich wiederholen, sodass man dasselbe Intervall nicht zehnmal beschreiben muss.
Drei Sportarten, drei Vokabulare
Laufen, Radfahren und Schwimmen im Becken akzeptieren nicht dieselben Ziele. Das Radfahren rechnet in absoluten Watt, das Schwimmen in Tempozonen und Bahnlänge, das Laufen in Tempo oder Prozent der VMA. Ein Workout, das die Vokabulare mischt, wird abgelehnt – oder schlimmer: akzeptiert und dann um sein Ziel gebracht.
Häufige Falle: Ein falsch deklariertes Herzfrequenzziel wird von der API akzeptiert und landet als freier Schritt ohne Vorgabe auf der Uhr. Das Workout existiert, aber es steuert nichts.
Was sie nicht ermöglicht
Die offizielle API ist kein Generalschlüssel. Mehrere Grenzen sind strukturell bedingt, und man kennt sie besser, bevor man darauf aufbaut.
- Der Zugang ist nicht frei: Man muss sich beim Garmin Developer Program bewerben und zugelassen werden. Eine Privatperson kann sie nicht für den persönlichen Gebrauch nutzen.
- Sie schreibt Workouts, keine Garmin Coach-Trainingspläne: Das sind zwei verschiedene Objekte.
- Sie gibt keine Aktivitäten weiter, die von Drittanbieter-Apps aufgezeichnet wurden. Eine Einheit auf einer virtuellen Trainingsplattform kommt über diesen Kanal nicht an.
- Die Audionotizen, die kürzlich zum Workout-Editor von Garmin Connect hinzugekommen sind, werden nicht bereitgestellt.
Diese Grenzen erklären, warum manche Tools bewusst einen anderen Weg wählen. Sie machen sie nicht zu einer schlechten API: Sie machen sie zu einer Partner-API, mit den üblichen Gegenleistungen.
Warum so viele Tools einen anderen Weg gehen
Die öffentlich auffindbaren Community-Projekte stützen sich fast alle auf eine Bibliothek, die die Anmeldung der Garmin Connect-App simuliert. Sie funktioniert, sie ist einfach zu installieren, und sie verlangt deinen Garmin-Benutzernamen und dein Garmin-Passwort.
Diese Entscheidung hat einen Preis, den man bei der Installation selten bedenkt: Deine Zugangsdaten verlassen Garmin, die erhaltenen Tokens laufen schnell ab, und das Tool funktioniert an dem Tag nicht mehr, an dem Garmin eine interne Adresse ändert. Mehrere dieser Projekte weisen im Übrigen selbst darauf hin, dass sie nicht für die kommerzielle Nutzung gedacht sind.
Eine einfache Faustregel, bevor du irgendetwas installierst: Verlangt das Tool dein Garmin-Passwort, nutzt es nicht die offizielle API. Mit ihr wird die Autorisierung auf einem Garmin-Bildschirm erteilt und über dein Garmin-Konto wieder entzogen.
Wie Running Workout vorgeht
Running Workout ist beim Garmin Developer Program zugelassen und schreibt über die offizielle Training API. Konkret ändert das drei Dinge für den Athleten.
- Es wird nie ein Garmin-Passwort verlangt: Das Konto wird einmal auf dem Autorisierungsbildschirm von Garmin verknüpft und über Garmin wieder getrennt.
- Die Workouts werden geschrieben und auf das gewünschte Datum geplant, dann mit der Uhr synchronisiert wie jedes von Hand erstellte Workout.
- Laufen, Radfahren drinnen oder draußen und Schwimmen im Becken werden unterstützt, mit den Zielen der jeweiligen Disziplin.
Der Dienst stellt diese Funktionen außerdem einem KI-Assistenten über einen Remote-Server bereit. So lässt sich ein Workout in natürlicher Sprache beschreiben und am Handgelenk wiederfinden. Darum geht es in der Verbindungsanleitung.
Häufige Fragen
Hat Garmin wirklich eine öffentliche API zum Schreiben von Workouts?
Ja. Die Training API gehört zum Garmin Developer Program und erlaubt es, strukturierte Workouts im Konto eines Nutzers zu erstellen und zu planen, der dem zugestimmt hat. Sie ist dokumentiert und wird gepflegt. Nicht öffentlich ist der Zugang: Man muss als Partner zugelassen sein.
Kann ich sie für meinen persönlichen Gebrauch nutzen?
Nicht direkt. Das Programm richtet sich an Dienste, nicht an Privatpersonen. Für den persönlichen Gebrauch bleiben die per Kabel übertragene FIT-Datei, eine Drittanbieter-Brücke oder ein bereits zugelassener Dienst, der die Funktion bereitstellt.
Ist ein Tool gefährlich, das mein Garmin-Passwort verlangt?
Es ist nicht unbedingt bösartig, aber du verlässt damit den vorgesehenen Rahmen: Deine Zugangsdaten werden außerhalb von Garmin gespeichert, du kannst den Zugriff nicht über dein Garmin-Konto widerrufen, und du hängst von internen Adressen ab, die sich ändern können. Die Autorisierung über einen Garmin-Bildschirm vermeidet alle drei Probleme.
Kommt ein per API geschriebenes Workout automatisch auf der Uhr an?
Ja, sobald es auf ein Datum geplant ist: Es landet bei der nächsten Synchronisierung auf der Uhr, genau wie ein in Garmin Connect erstelltes Workout. Ein ohne Datum erstelltes Workout bleibt in der Bibliothek des Kontos.
Lassen sich auch Schwimm- und Radeinheiten schreiben oder nur Laufeinheiten?
Alle drei. Jede Sportart hat ihre eigenen Ziele: Watt und Trittfrequenz beim Radfahren, Tempozonen und Bahnlänge beim Schwimmen, Tempo oder Prozent der VMA beim Laufen. Man muss das Vokabular jeder Sportart einhalten, sonst verschwindet das Ziel stillschweigend.
Lass deinen Assistenten deine Einheiten schreiben
Running Workout verbindet Claude, ChatGPT oder Gemini über die offizielle API mit deinem Garmin-Konto. Nichts zu installieren, kein Garmin-Passwort herauszugeben.
Zur Verbindungsanleitung