Hevy
Connect Hevy with your own API key to bring strength training into VitalTrends next to WHOOP, Oura, Apple Health, and Strava workouts.
What syncs
- Workouts with title, notes, start and end time, duration, and Hevy update time.
- Exercises, exercise template IDs, notes, supersets, set type, reps, weight, distance, duration, and RPE.
- Derived strength metrics such as total volume, set count, exercise count, PRs, volume trends, and frequency.
- Hevy exercise templates for muscle-group rollups when the API includes template metadata.
Connect
- Open Hevy developer settings and create or copy an API key.
- In VitalTrends, go to Connections -> Hevy.
- Paste the key and save. VitalTrends validates the key, subscribes a webhook when available, then starts a backfill.
How sync works
The first sync paginates through Hevy workouts, then stores each workout, exercise, and set in normalized tables. After that, the hourly delta job and the Hevy webhook keep edits and deletions current. If Hevy returns an authentication error, the connection is marked for reconnection and the encrypted key is left untouched until you replace it.
Workout views
Hevy appears in the unified workout feed. When a Hevy strength workout and an Apple Health strength workout start within two minutes and have compatible durations, VitalTrends treats them as one session and prefers Hevy as the primary strength log. The dedicated Hevy hub shows volume, PRs, muscle-group rollups, recent sessions, and how the latest lift session lined up with the next morning's WHOOP recovery or Oura readiness.
API and export
Use GET /api/v1/workouts/hevy for Hevy workout rows with nested exercises and sets, or GET /api/v1/workouts/unified for the merged cross-source workout feed. Data export includes a Hevy CSV with one row per set.
Webhook endpoint
VitalTrends registers POST /webhooks/hevy/{secret} as the callback URL for Hevy events. The secret is generated per connection and can be rotated from the Hevy connection page.