Garmin Connect¶

PeakLine integrates directly with Garmin Connect, primarily as a route for getting wellness data (sleep, HRV, body battery) and as a backup pipeline for activities that didn't make it to Strava.

Beta

The Garmin integration is in beta. The Strava integration remains the recommended primary path for activity sync; Garmin is most valuable for the data Strava doesn't expose.

What you can pull from Garmin¶

The integration uses Garmin's own session-based API (the same flow the official Garmin Connect website uses). Once connected, PeakLine can read:

Activities — including those marked private on Strava, since Garmin sees everything your device records.
Sleep data — total sleep, sleep stages (light / deep / REM / awake), sleep score.
Heart Rate Variability (HRV) — daily morning HRV reading, 7-day baseline, status (Balanced / Unbalanced / Low / Poor).
Body Battery — Garmin's energy reserve metric across the day.
Stress — Garmin's autonomic stress score, all-day.
Resting HR — daily resting heart rate trend.
Training load and recovery — Garmin's own training load and recovery time estimates.

What we don't read: detailed health data (SpO₂, skin temperature, menstrual tracking, etc.). These are off-scope for an athletic-performance tool.

Connecting¶

Open Settings → Integrations → Garmin in PeakLine.
Enter your Garmin Connect email and password.
If your account has MFA enabled (it should), you'll be prompted for the 6-digit code from your authenticator app.
PeakLine establishes a session and stores an encrypted session token. We do not store your password — it's used once to obtain the session and then immediately discarded.

The session is renewed automatically when it expires. If a renewal fails (Garmin sometimes invalidates sessions after a long period of inactivity), you'll be prompted to log in again.

What the dashboard shows¶

With Garmin connected, the dashboard surfaces:

HRV trend — last 7 / 28 days, with status icon.
Sleep last night — duration, stages, score.
Body battery now — current level + the chart for the past 24 hours.
Stress 7-day average — useful as a recovery indicator.

These appear as additional cards above the activity feed. None of this displaces Strava data — the integrations coexist.

How HRV interacts with training¶

HRV is the best simple proxy for autonomic recovery. PeakLine uses it in two places:

AI Coach — when generating an activity summary, the prompt includes your morning HRV reading. A summary might say "Your morning HRV was low (32 ms, status: Unbalanced); the hard interval session likely pushed you deeper into fatigue. Consider Z1 tomorrow."
Stress Points sanity-check — if your rolling 7-day SP is high and your HRV has been below baseline for 3+ days, the dashboard surfaces a "potential overreaching" yellow banner.

This is informational only. PeakLine doesn't auto-adjust your training plan; it just shows you the patterns.

Limitations¶

Unofficial API. Garmin doesn't publish an official partner API for individuals. The integration uses the same calls that the Garmin Connect web app uses, which means:
- Garmin can change the API at any time, which can break the integration until we update.
- Some account types (e.g., enterprise / family-managed) may not work.
No write access. PeakLine cannot push activities, workouts, or routes back to Garmin Connect. (Garmin doesn't expose a write API for unofficial integrations.)
MFA codes. Each reconnect needs a fresh MFA code — Garmin doesn't issue long-lived tokens to non-partner apps.
Family-shared accounts. If you have a "family" Garmin account, PeakLine sees only the primary athlete.

Privacy¶

The encrypted Garmin session token lives in our database alongside your PeakLine account. Disconnecting Garmin deletes the session token immediately. Deleting your PeakLine account purges it too.

We never transmit your Garmin credentials anywhere except to Garmin's own login endpoint, and only at connection / re-connection time.