Samsung Health integration

How to integrate with the Samsung Health SDK: ROOK simplifies access to Samsung Health wearable data for health, fitness, and insurance apps.

Samsung Health to ROOK Connect to Your backend: how Samsung Health data reaches your product through ROOK.

How it connects

ROOK reads Samsung Health data on the phone through its mobile SDKs.

ROOK's SDK delivers body metrics, physical activity and sleep from Samsung Health as structured JSON, by webhook and API.

Leverage Samsung Health data to personalize user experiences, driving higher engagement and retention.

Our Samsung Health integration delivers notifications within minutes after a user completes an event and syncs their app.

Your own Samsung Health developer account is required.

Read the Samsung Health docs
ROOK Connectphysical_summary · JSON
{  "data_structure": "physical_summary",  "user_id": "demo-user-01",  "physical_health": { "summary": { "physical_summary": {    "metadata": {      "sources_of_data_array": ["Samsung Health"]    },    "distance": {      "steps_int": 8432,      "active_steps_int": 6120,      "walked_distance_meters_float": 6180.0    },    "activity": { "active_seconds_int": 3240 }  } } }}
ROOK Connectsleep_summary · JSON
{  "data_structure": "sleep_summary",  "user_id": "demo-user-01",  "sleep_health": { "summary": { "sleep_summary": {    "metadata": {      "sources_of_data_array": ["Samsung Health"]    },    "duration": {      "sleep_duration_seconds_int": 26400,      "deep_sleep_duration_seconds_int": 6300,      "rem_sleep_duration_seconds_int": 5400    },    "heart_rate": { "hr_resting_bpm_int": 56 }  } } }}
ROOK Connectbody_summary · JSON
{  "data_structure": "body_summary",  "user_id": "demo-user-01",  "body_health": { "summary": { "body_summary": {    "metadata": {      "sources_of_data_array": ["Samsung Health"]    },    "heart_rate": {      "hr_avg_bpm_int": 67,      "hr_resting_bpm_int": 58    },    "oxygenation": { "saturation_avg_percentage_int": 97 }  } } }}

Available data

The Samsung Health data ROOK delivers.

Every field below comes from the Samsung Health documentation and arrives in ROOK's standard structure, whatever device the user wears.

Physical health

physical activity event35 fields

  • active_seconds_int
  • activity_duration_seconds_int
  • activity_end_datetime_string
  • activity_start_datetime_string
  • activity_type_name_string
  • calories_expenditure_kcal_float
  • calories_net_active_kcal_float
  • calories_intake_kcal_float
  • steps_int
  • traveled_distance_meters_float
  • floors_climbed_float
  • hr_minimum_bpm_int
  • hr_maximum_bpm_int
  • hr_granular_data_array
  • hr_avg_bpm_int
  • saturation_granular_data_array
  • saturation_avg_percentage_int
  • elevation_avg_altitude_meters_float
  • elevation_maximum_altitude_meters_float
  • elevation_minimum_altitude_meters_float
  • elevation_loss_actual_altitude_meters_float
  • elevation_gain_actual_altitude_meters_float
  • speed_avg_meters_per_second_float
  • speed_maximum_meters_per_second_float
  • cadence_avg_rpm_float
  • cadence_maximum_rpm_float
  • swimming_num_strokes_float
  • swimming_pool_length_meters_float
  • swimming_total_distance_meters_float
  • position_start_object
  • position_end_object
  • position_centroid_object
  • position_granular_data_array
  • power_avg_watts_float
  • power_maximum_watts_float

physical summary13 fields

  • steps_int
  • traveled_distance_meters_float
  • floors_climbed_float
  • saturation_avg_percentage_int
  • saturation_granular_data_array
  • active_seconds_int
  • calories_expenditure_kcal_float
  • calories_net_intake_kcal_float
  • calories_net_active_kcal_float
  • hr_minimum_bpm_int
  • hr_maximum_bpm_int
  • hr_avg_bpm_int
  • hr_granular_data_array

physical heart rate event4 fields

  • hr_avg_bpm_int
  • hr_minimum_bpm_int
  • hr_maximum_bpm_int
  • hr_granular_data_array

physical oxygenation event2 fields

  • saturation_granular_data_array
  • saturation_avg_percentage_int

Sleep health

sleep summary17 fields

  • deep_sleep_duration_seconds_int
  • sleep_duration_seconds_int
  • time_in_bed_seconds_int
  • sleep_date_string
  • rem_sleep_duration_seconds_int
  • sleep_start_datetime_string
  • light_sleep_duration_seconds_int
  • sleep_end_datetime_string
  • time_awake_during_sleep_seconds_int
  • hr_avg_bpm_int
  • hr_granular_data_array
  • hr_minimum_bpm_int
  • hr_maximum_bpm_int
  • saturation_avg_percentage_int
  • saturation_minimum_percentage_int
  • saturation_granular_data_array
  • saturation_maximum_percentage_int

Body health

body summary24 fields

  • bmi_float
  • weight_kg_float
  • height_cm_int
  • blood_glucose_granular_data_array
  • blood_glucose_avg_mg_per_dL_int
  • blood_pressure_granular_data_array
  • blood_pressure_avg_object
  • water_total_consumption_mL_int
  • hydration_amount_granular_data_array
  • hr_avg_bpm_int
  • hr_minimum_bpm_int
  • hr_maximum_bpm_int
  • hr_granular_data_array
  • calories_intake_kcal_float
  • protein_intake_g_float
  • sugar_intake_g_float
  • fat_intake_g_float
  • trans_fat_intake_g_float
  • carbohydrates_intake_g_float
  • fiber_intake_g_float
  • sodium_intake_mg_float
  • cholesterol_intake_mg_float
  • saturation_granular_data_array
  • saturation_avg_percentage_int

body blood glucose event3 fields

  • blood_glucose_granular_data_array
  • blood_glucose_avg_mg_per_dL_int
  • device_source_data_array

body blood pressure event3 fields

  • blood_pressure_granular_data_array
  • blood_pressure_avg_object
  • device_source_data_array

body metrics event3 fields

  • bmi_float
  • weight_kg_float
  • height_cm_int

body heart rate event4 fields

  • hr_avg_bpm_int
  • hr_minimum_bpm_int
  • hr_maximum_bpm_int
  • hr_granular_data_array

body hydration event2 fields

  • water_total_consumption_mL_int
  • hydration_amount_granular_data_array

body oxygenation event3 fields

  • saturation_granular_data_array
  • saturation_avg_percentage_int
  • device_source_data_array

body temperature event5 fields

  • temperature_avg_object
  • temperature_maximum_object
  • temperature_granular_data_array
  • temperature_minimum_object
  • device_source_data_array

body nutrition event9 fields

  • calories_net_intake_kcal_float
  • protein_intake_g_float
  • sugar_intake_g_float
  • fat_intake_g_float
  • trans_fat_intake_g_float
  • carbohydrates_intake_g_float
  • fiber_intake_g_float
  • sodium_intake_mg_float
  • cholesterol_intake_mg_float

Get started

Connect Samsung Health in three steps.

  1. Enable Samsung Health in the ROOK portalAdd Samsung Health as a data source with the credentials of your own Samsung Health developer account.
  2. Let users connect Samsung Health on their phoneUsers grant access to Samsung Health in your app through the ROOK SDK or ROOK App.
  3. Receive standardized dataROOK turns Samsung Health data into the same JSON structure as every other data source and delivers it to your backend by webhook and API.

Use cases

What teams build with Samsung Health data.

From seamless wearable integrations to advanced health insights, ROOK empowers you to build personalized wellness apps, research platforms, fitness dashboards, chronic care solutions and many more great use cases.

More data sources

More data sources ROOK reads through its mobile SDKs.

FAQ

Frequently asked questions about the Samsung Health integration

What teams ask before they connect Samsung Health through ROOK.

What Samsung Health data can I get through ROOK?

ROOK extracts 127 Samsung Health fields covering physical activity, sleep and body and vital signs data, grouped into summaries and events. The data each user shares depends on the permissions they grant when they connect Samsung Health.

How quickly does Samsung Health data reach my backend?

Our Samsung Health integration delivers notifications within minutes after a user completes an event and syncs their app.

Do I need my own Samsung Health developer account?

Yes. Samsung Health requires each ROOK client to register its own developer account to authorize health data extraction.

How does ROOK connect to Samsung Health?

Through ROOK's mobile SDKs, because Samsung Health keeps its data on the phone. ROOK App offers the same connection without building a mobile app.

Read the Samsung Health documentation
Still have questions?Our team can review your sources and use case with you.
Schedule a demo

Articles on Samsung Health from the ROOK blog

Build on better health data

Turn fragmented health data into your next product advantage.

Connect the sources your users rely on, standardize what comes back, and build workflows that respond to change.

Newsletter

Stay in the loop.

Sign up with your email address to receive news and updates from the ROOK team.

We respect your privacy. Read our privacy policy.