Health Integrations

fitbit_client_id=23ABC4
fitbit_client_secret=abc123...
fitbit_access_token=eyJ...   # returned by the OAuth callback
fitbit_refresh_token=abc...  # returned by the OAuth callback

google_fit_client_id=123456...apps.googleusercontent.com
google_fit_client_secret=GOCSPX-...
google_fit_access_token=ya29...    # returned by callback
google_fit_refresh_token=1//...    # returned by callback

oura_api_key=YOUR_PERSONAL_TOKEN

withings_client_id=abc123
withings_client_secret=def456
withings_access_token=...   # returned by callback
withings_refresh_token=...  # returned by callback

garmin_email=you@email.com
garmin_password=your-garmin-password

health_webhook_secret=some-long-random-string

{
  "data": {
    "metrics": [
      {
        "name": "heart_rate",
        "units": "bpm",
        "data": [
          { "date": "2026-05-21T08:32:00+00:00", "qty": 68 },
          { "date": "2026-05-21T09:15:00+00:00", "qty": 72 }
        ]
      },
      {
        "name": "step_count",
        "units": "count",
        "data": [
          { "date": "2026-05-21", "qty": 8432 }
        ]
      }
    ]
  }
}

# All platform statuses
curl http://localhost:8899/api/health/status

# Today's cross-platform summary
curl http://localhost:8899/api/health/summary

# Last 30 days of heart rate from Fitbit
curl "http://localhost:8899/api/health/metrics?platform=fitbit&metric_type=heart_rate&from=2026-04-21&to=2026-05-21"

# Trigger sync for all configured platforms
curl -X POST http://localhost:8899/api/health/sync

# Sync only Oura
curl -X POST "http://localhost:8899/api/health/sync?platform=oura"

# Sync yesterday's data
curl -X POST "http://localhost:8899/api/health/sync?platform=fitbit&date=2026-05-20"

# Start Fitbit OAuth (open in browser)
open http://localhost:8899/api/health/oauth/authorize/fitbit

{
  "date": "2026-05-21",
  "metrics": {
    "steps":             [{ "platform": "fitbit", "value": 8432,  "unit": "steps" }],
    "heart_rate":        [{ "platform": "fitbit", "value": 72,    "unit": "bpm" },
                          { "platform": "oura",   "value": 69,    "unit": "bpm" }],
    "hrv":               [{ "platform": "oura",   "value": 48,    "unit": "ms" }],
    "sleep_duration_min":[{ "platform": "fitbit", "value": 444,   "unit": "min" }],
    "sleep_deep_min":    [{ "platform": "fitbit", "value": 82,    "unit": "min" }],
    "readiness_score":   [{ "platform": "oura",   "value": 82,    "unit": "score" }],
    "weight_kg":         [{ "platform": "withings","value": 74.2, "unit": "kg" }]
  }
}

"How was my sleep last night?"
→ You slept 7h 24m with 82 min deep and 1h 48m REM. HRV was 48ms — solid recovery.

"How many steps did I take this week?"
→ Your 7-day average is 9,241 steps. Best day was Thursday at 12,800.

"Is my heart rate normal?"
→ Resting HR today is 62bpm, down from your 30-day average of 68. That's a positive trend.

"How's my readiness today?"
→ Oura scores your readiness at 82/100. Your HRV is above your average and sleep debt is low.

"Sync my Fitbit and tell me how my recovery looks"
→ (syncs Fitbit, then answers based on fresh data)

"Show me my blood pressure readings from the past week"
→ (queries Withings data, summarizes the trend)

"How does my sleep compare to last month?"
→ (queries last 30 days, computes averages, compares)

"I went for a run today — did my heart rate zones look right?"
→ (reads Garmin workout data if synced)