Apple Health App Sync Documentation
HealthSync gives developers and quantified-self users a direct path from Apple Health on iPhone to a private API without granting a third-party cloud broad access to their health data.
The public product and setup overview lives at the HealthSync Apple Health app sync guide . This page summarizes the technical implementation for people evaluating the open-source project.
Sync Model
- The iOS app requests HealthKit permission on-device for selected data types.
- HealthSync normalizes supported metrics and workouts into JSON payloads.
- Batches are stored locally before upload, then posted to the configured backend URL.
- The backend accepts authenticated
POST /api/apple-health/syncrequests. - Users can self-host the FastAPI backend or use hosted storage when enabled.
Best-Fit Use Cases
- Self-hosted Apple Health dashboards backed by Postgres, Grafana, or custom APIs.
- Personal data warehouses where HealthKit export files are too slow or manual.
- AI agent workflows that need private, read-only access to selected health history.
- Developer prototypes that need real HealthKit data without building the whole iOS sync layer.