Connect Apple Health
The VitalTrends iOS companion app bridges Apple Health and your dashboard. Once paired, it continuously streams your health samples so you get the full picture alongside WHOOP and Withings.
Steps
An active subscription is required. Go to Pricing to get started.
Go to Settings → Connections and find the Apple Health card.
Click Connect Apple Health. A one-time pairing code will appear. Keep this screen open on your computer.
Download the app via TestFlight on your iPhone. Open it and tap Pair with account.
Type in the pairing code shown on the Connections page. The app will confirm the pairing and prompt you to grant Apple Health permissions.
iOS will ask which data types the app can read. Enable the categories you want to sync. You can adjust these later in iPhone Settings → Health → Data Access & Devices.
The app will start uploading your Apple Health history. Large libraries (years of data) may take several minutes on the first run. For the best experience, keep the app open in the foreground until the upload completes, as background processing can be interrupted by iOS. Once the initial sync is done, all future syncs are incremental and much faster.
How data stays fresh
Background sync
The iOS app uploads new samples whenever the system grants background processing time, typically multiple times per day. You can also open the app and tap Sync now to force an immediate upload.
Aggregation pipeline
Apple Health records at very fine granularity (heart rate every few seconds, distance every few steps). VitalTrends groups consecutive samples of the same type into sessions automatically. Summable types like steps are totaled; averageable types like heart rate are averaged with min/max stored. This keeps the dashboard fast without losing resolution.
Supported data types
| Type | How it appears |
|---|---|
| Steps | Daily total, 30-day chart |
| Active energy (kcal) | Daily total, trend chart |
| Basal energy (kcal) | Daily total |
| Distance (km) | Daily total |
| Heart rate (bpm) | Session average, min, max |
| HRV (ms) | Daily latest reading |
| Resting heart rate | Daily value |
| SpO2 (%) | Session average |
| Respiratory rate | Session average |
| Sleep analysis | Sleep stages, duration |
| Workouts | Activity type, duration, energy |
| Body mass (kg) | Latest reading per day |
| Body fat (%) | Latest reading per day |
Troubleshooting
Pairing code expired
Pairing codes are valid for 15 minutes. Return to the Connections page and generate a new code.
No data appearing after pairing
Open the iOS app and tap Sync now. Check that Apple Health permissions are granted in iPhone Settings → Health → Data Access & Devices → VitalTrends.
Only recent data uploaded
The first upload sends as much history as Apple Health allows the app to read. Some older data may require opening the app on each day's records, depending on iOS privacy limits.