How to Integrate Samsung Health with the Data SDK (2026)

On Samsung's developer site, the way to Samsung Health data is the Samsung Health Data SDK, an Android library that lets your app read, and with approval write, selected data in the Samsung Health app's data store on the user's phone. That store also holds data from connected devices: Samsung says a Galaxy Watch or Galaxy Ring automatically transfers its data to the paired phone's Samsung Health app, and lists Galaxy Fit, blood glucose monitors and weight scales among the accessories. Everything below is from Samsung's developer site as read on October 17, 2026. For the comparable Google platform, see Google Health Connect.

Samsung has two other health SDKs that this guide does not cover: the older Samsung Health SDK for Android, which Samsung deprecated as of July 31, 2025 in favor of the Data SDK, and the Samsung Health Sensor SDK, which runs on Galaxy Watch4 and later and exposes raw sensor signals such as accelerometer, ECG and PPG to watch apps.

Access and approval#

Samsung describes the partnership as "an exclusive service for the Samsung Health Data SDK that allows users to discover engaging health and fitness apps". Its pages do not mention fees.

Requirements#

• Samsung Health version 6.30.2 or later on the phone; the SDK needs Samsung Health installed.
• Android 10 (API level 29) or later. Samsung Health runs on all Samsung smartphones and on non-Samsung Android phones.
• Java 17 or later.
• A real device: the SDK does not support emulators.
• Samsung says data measured using the SDK is for fitness and wellness purposes only, not for diagnosing or treating any medical condition.

The version on Samsung's download page on October 17, 2026 was Samsung Health Data SDK v1.1.0, shipped as an .aar library you add to your module.

Permissions#

Each data type has its own permission, with read and write separate, and the user grants them in a Samsung Health pop-up. Check what is already granted when your app starts, and request the rest:

// Names from Samsung's Health Data SDK code lab
val store = HealthDataService.getStore(applicationContext)
val permissions = setOf(
    Permission.of(DataTypes.STEPS, AccessType.READ),
    Permission.of(DataTypes.STEPS_GOAL, AccessType.READ),
)
if (!store.getGrantedPermissions(permissions).containsAll(permissions)) {
    store.requestPermissions(permissions, activity)
}

Samsung's guidance is not to repeat a request the user keeps denying, and to explain in your settings screen how to allow it in Samsung Health instead.

Data: what you can read and write#

Queries can filter and aggregate. Samsung's code lab totals today's steps with an AggregateRequest on DataType.StepsType.TOTAL and a LocalTimeFilter, and groups by hour with a LocalTimeGroup; groupings run from MINUTELY to YEARLY. The aggregate functions combine sources for you, for example total steps from several devices, and only periods with a non-zero step count come back.

val request = DataType.StepsType.TOTAL.requestBuilder
    .setLocalTimeFilter(LocalTimeFilter.of(startOfDay, now))
    .build()
val total = store.aggregateData(request).dataList.firstOrNull()?.value ?: 0L

Two other features matter for sync. HealthDataStore.readChanges() returns what changed for a data type and time filter: new, updated or deleted data, with the deleted data's ID or the new data point and the change time. And every data point carries its source device, so DeviceManager.getDevice(deviceId) tells you whether a value came from a Galaxy Watch, Galaxy Ring, Galaxy Fit, the phone or an accessory.

Errors you will meet#

Webhooks and rate limits#

Samsung's pages describe no push notifications and no request limits for the Data SDK, which reads from the Samsung Health app on the same phone. To find what is new since your last read, use readChanges().

What changed recently#

Gotchas and production notes#

• Android, on the phone. The Data SDK reads Samsung Health on the user's Android phone; the Samsung pages we read describe no iOS SDK or cloud API for this data.
• Partnership before release. Without registration your app works only in developer mode, so plan the partner request into your launch.
• Writes need an access code. Request it through the same partnership process.
• Galaxy Ring and Watch data arrive through the phone. Your app reads them from Samsung Health once the wearable has synced.
• Wellness, not diagnosis. Samsung's own limitation applies to anything you build.

The rest of the cluster is at how to integrate a fitness or health API.