Hevy
Connect Hevy with your own API key to sync strength training into VitalTrends.
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. Your Hevy sessions also show up in the Training Log alongside every other source, so you can review and edit your strength history from one place.
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.