Health Connect

With Thryve you can easily integrate your application with Health Connect, Google's on-device health data platform for Android, via the ThryveHealthConnect module

ThryveHealthConnect handles the Health Connect permission flow so your app can easily read the health data - steps, vitals, sleep, nutrition, and more - written by the user's other apps and devices, without having to integrate each source separately.

Health Connect is built into Android 14+ and available as a downloadable app on Android 9 (API 28) and above. The ThryveHealthConnect module itself supports Android 8 (API 26) and above, so your app can still run on older devices - Health Connect features simply won't be available there. See Setup Thryve SDK → Android for project configuration and required manifest permissions.

Data availability

Health Connect only exposes data that has already been written to it by another app on the user's device (e.g. Samsung Health, Fitbit, Oura, Google Fit-successor apps). If no source app is writing a given data type to Health Connect, Thryve will not receive it either - direct device/sensor access is not possible through this module.

Capabilities

• Lifecycle & permissions: Connects and disconnects via start / stop, checks availability and active state, requests and tracks Health Connect read permissions, and supports optional features like read-history and background read.

• Incremental sync : synchronize function uses Health Connect change tokens to pull new/updated records since the last sync and upload them to the Thryve backend.

• Background sync: Optional WorkManager-based background sync that runs periodic health data sync when enabled in config.

• Historical backfill : backfillDaily aggregates daily metrics (steps, calories, distance, heart rate, sleep, etc.) over a date range; backfillEpoch reads raw epoch records over a date range (up to 30 days).

• Data types, configuration & provider support: Maps 40+ Health Connect data types into Thryve’s standardised format. Configure data types, the Health Connect provider package name, background sync, and read-history access.

• Observability: OpenTelemetry-style spans for sync, backfill, permission checks, reads, and uploads to aid debugging and monitoring.

Health Connect determines which data is returned based on the user’s configured data source/app priority. When multiple apps or devices provide overlapping data, the prioritized source may determine which records are included in aggregated Health Connect results. As a result, the data available to the Thryve SDK depends on the data Health Connect makes available after applying these source-priority rules.

When validating missing or unexpected data, also verify the user’s Health Connect data source priority settings.

Supported Data Types

The ThryveHealthConnect module supports over 40 Health Connect record types. We map these records to Thryve's standard data types. See the table below for the full list of supported data types.

How to integrate Thryve SDK Health Connect module

Follow these instructions to integrate and connect to Health Connect