Connect Garmin
Connect Garmin to Omnio to import activity, heart rate, sleep, VO2 max, body battery, training readiness, and recovery data.
What data syncs
Omnio pulls the following from Garmin Connect:
| Category | Metrics |
|---|---|
| Sleep | Total sleep, deep/REM/light hours, sleep score, respiratory rate, SpO2, HRV |
| Readiness | Training readiness score, body battery, stress level |
| Activity | Steps, active calories, active minutes, floors climbed, VO2 Max estimate |
| Heart rate | Resting heart rate, HRV (overnight), max HR |
| Workouts | Duration, type, average/max HR, calories, training effect |
On first connect, Omnio fetches 30 days of historical data.
How to connect
Garmin doesn’t offer a public OAuth API for third-party apps, so Omnio authenticates using your Garmin Connect credentials via the garth library (the same method used by popular open-source Garmin tools).
- Go to Sources → Accounts tab.
- Click Connect Garmin.
- Enter your Garmin Connect email and password.
- If your account has MFA enabled, you’ll be prompted for a verification code. Check your email or authenticator app and enter the code.
- After successful authentication, your first sync begins automatically.
Your password is not stored. Omnio uses your credentials to obtain a session token (garth tokens), then discards the password. Only the session token is saved, encrypted at rest.
MFA (Multi-Factor Authentication)
If Garmin requires MFA:
- Omnio detects the MFA challenge and shows a code input field.
- Enter the 6-digit code from your email or authenticator app.
- You have 5 minutes to enter the code before the session expires.
- After successful verification, the account is created with the session token.
Sync frequency
Garmin data syncs periodically (roughly every 2 hours). Unlike Oura, Garmin does not currently support webhook-based push notifications through this integration.
Token expiration
Garmin session tokens (garth tokens) can expire after extended periods. If a sync fails due to expired tokens, the account status changes to disconnected. You’ll need to re-enter your credentials to reconnect.
Troubleshooting
- “Authentication failed” error — Double-check your Garmin Connect email and password. If you recently changed your password, use the new one.
- MFA code expired — You have 5 minutes. Go back to Sources and try connecting again to get a fresh MFA challenge.
- Timeout error — Garmin’s servers occasionally respond slowly. Wait a minute and try again.
- Missing VO2 Max — VO2 Max estimates require a Garmin device that supports this feature (most Forerunner and Fenix models). If your device doesn’t report it, this metric won’t appear.
- Disconnected status — Re-enter your Garmin credentials from Sources → Accounts → Reconnect.