Why are Apple Health HR, sleep stages or GPS missing?
Missing detail in Apple Health payloads almost always means the source did not record it, or a HealthKit permission was not granted, not a pipeline failure.
Last updated
Was this helpful?
Missing detail in Apple Health payloads almost always means the source did not record it, or a HealthKit permission was not granted, not a pipeline failure.
Missing detail in Apple Health payloads almost always means the source did not record it, or a HealthKit permission was not granted, not a pipeline failure. First, ensure you are on the latest SDK version (recent releases improved background sync and sample collection), then check by field:
Sleep stages: older Apple devices only record asleep/awake, so light/deep/REM are null while total asleep is populated. Check the Health app's sleep graph.
Workout HR: a workout object can sync before its detailed HR, so trigger a backfill (you must call initTerra again so the SDK picks it up on next foreground).
Sparse HR: usually means the watch did not record continuous HR (Workout Power Saving Mode disables the HR sensor, plus wrist fit). Confirm via the HR graph in Apple Fitness/Health.
GPS: no route is recorded for indoor types, auto-detected short walks/runs, or manual/third-party workouts, and the 'Workout Route' permission must be enabled in iOS Settings > Privacy & Security > Health.
Athlete payload: the user must grant read access to characteristics like Gender and Date of Birth at the HealthKit prompt.
If it persists after these checks, share user_id, dates and source-app screenshots for investigation.
Last updated
Was this helpful?
Was this helpful?