React Native Health Data Integration

Read the Mobile SDK Integration Guide first. It covers what is the same on every platform: the backend token endpoint, the SDK lifecycle, and the production checklist. This page shows the React Native calls for each step.

Installation currently takes a few extra steps. The package is not on npm yet, so you install it from GitHub, and on Android its native dependency has to be published to Maven Local first. See Installation. We’re working on publishing the package to npm and serving the Android dependency from a public repository, after which both steps go away.

Configure on Every Launch

import { useEffect } from "react";
import OpenWearablesHealthSDK from "open-wearables";

const OW_HOST = "https://api.your-open-wearables.com";

export default function App() {
  useEffect(() => {
    OpenWearablesHealthSDK.configure(OW_HOST);
  }, []);
  // ...
}

isSessionValid(), isSyncActive(), getStoredCredentials(), getSyncStatus(), getAvailableProviders() and setProvider() are synchronous - no await needed. Once per user, when isSessionValid() is false, with tokens from your backend endpoint:

const res = await fetch("https://api.yourapp.com/api/health/token", {
  method: "POST",
  headers: { Authorization: `Bearer ${yourAuthToken}` },
});
const { userId, accessToken, refreshToken } = await res.json();

await OpenWearablesHealthSDK.signIn(userId, accessToken, refreshToken, null);

When token refresh fails, get new tokens and call updateTokens() - not signIn():

const sub = OpenWearablesHealthSDK.addListener("onAuthError", async () => {
  try {
    const { accessToken, refreshToken } = await fetchTokensFromYourBackend();
    OpenWearablesHealthSDK.updateTokens(accessToken, refreshToken);
  } catch {
    // sync stays unauthenticated - ask the user to reconnect
  }
});

Select the Provider (Android)

import { Platform } from "react-native";

if (Platform.OS === "android") {
  const providers = OpenWearablesHealthSDK.getAvailableProviders();
  // [{ id: "samsung", displayName: "Samsung Health", isAvailable }, { id: "google", displayName: "Health Connect", isAvailable }]
  const ok = OpenWearablesHealthSDK.setProvider("google"); // false if Health Connect isn't installed
}

On iOS, getAvailableProviders() returns a single apple entry. The stored choice is available as getStoredCredentials().provider.

Request Permissions

import OpenWearablesHealthSDK, { HealthDataType } from "open-wearables";

await OpenWearablesHealthSDK.requestAuthorization([
  HealthDataType.Steps,
  HealthDataType.HeartRate,
  HealthDataType.Sleep,
  HealthDataType.Workout,
]);

See Supported Health Data Types for the full list, and Request permissions for what the returned boolean means on each platform.

Start Background Sync

const started = await OpenWearablesHealthSDK.startBackgroundSync(90); // days of history; 0 = all history
if (!started) {
  // not configured, not signed in, or (iOS) no authorized types
}

Other sync calls, all described in the SDK README:

Call	Notes
`stopBackgroundSync()`	Stops background sync. Anchors are kept.
`getSyncStatus()`	`isSyncing`, `initialExportDone`, `sentCount`, `hasResumableSession`, …
`resetAnchors()`	Forces a full re-sync. Call it while sync is stopped.
`setSyncInterval(minutes)`	Android only (minimum 15). No-op on iOS.

Logging

import OpenWearablesHealthSDK, { OWLogLevel } from "open-wearables";

OpenWearablesHealthSDK.setLogLevel(OWLogLevel.Always); // None | Always | Debug (default: debug builds only)
const sub = OpenWearablesHealthSDK.addListener("onLog", ({ message }) => console.log("[OW]", message));

Disconnect

// SDK provider id -> Open Wearables provider slug
const PROVIDER_SLUGS: Record<string, string> = { apple: "apple", google: "health_connect", samsung: "samsung" };

const { userId, provider } = OpenWearablesHealthSDK.getStoredCredentials();
// The stored access token may have expired, so get a fresh one from your backend
const { accessToken } = await fetchTokensFromYourBackend();

const res = await fetch(`${OW_HOST}/api/v1/users/${userId}/connections/${PROVIDER_SLUGS[provider!]}`, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${accessToken}` },
});
// 404 means there was no connection to revoke. On any other error keep the
// session, so the user can retry - after signOut() the SDK has no credentials left.
if (!res.ok && res.status !== 404) {
  throw new Error(`Disconnect failed: ${res.status}`);
}

await OpenWearablesHealthSDK.stopBackgroundSync();
OpenWearablesHealthSDK.signOut();

Expo and Bare React Native Setup

On top of the production checklist:

Expo: add the config plugin to app.json (see Installation). It sets the HealthKit entitlements, Info.plist usage texts, background modes and task identifiers on iOS, and the Health Connect permission-rationale activity aliases on Android.
The plugin replaces UIBackgroundModes. If your app needs other modes (e.g. remote-notification), check Info.plist after npx expo prebuild and add them back.
Expo, Android: set minSdkVersion: 29 with expo-build-properties.
Bare React Native: install Expo modules, then add the iOS entitlements and Info.plist keys yourself, and the Health Connect activity aliases described in the Android integration guide.

Complete Example

import { useEffect, useState } from "react";
import { Platform } from "react-native";
import OpenWearablesHealthSDK, { HealthDataType } from "open-wearables";

const OW_HOST = "https://api.your-open-wearables.com";
const TYPES = [HealthDataType.Steps, HealthDataType.HeartRate, HealthDataType.Sleep, HealthDataType.Workout];

async function fetchTokens(authToken: string) {
  const res = await fetch("https://api.yourapp.com/api/health/token", {
    method: "POST",
    headers: { Authorization: `Bearer ${authToken}` },
  });
  if (!res.ok) throw new Error("Failed to get SDK tokens");
  return res.json() as Promise<{ userId: string; accessToken: string; refreshToken: string }>;
}

export function useHealthSync(authToken: string) {
  const [connected, setConnected] = useState(false);

  useEffect(() => {
    OpenWearablesHealthSDK.configure(OW_HOST); // every launch
    setConnected(OpenWearablesHealthSDK.isSessionValid());

    const sub = OpenWearablesHealthSDK.addListener("onAuthError", async () => {
      try {
        const { accessToken, refreshToken } = await fetchTokens(authToken);
        OpenWearablesHealthSDK.updateTokens(accessToken, refreshToken);
      } catch {
        setConnected(false); // the user has to reconnect
      }
    });
    return () => sub.remove();
  }, [authToken]);

  async function connect() {
    const { userId, accessToken, refreshToken } = await fetchTokens(authToken);
    await OpenWearablesHealthSDK.signIn(userId, accessToken, refreshToken, null); // once per user

    if (Platform.OS === "android" && !OpenWearablesHealthSDK.setProvider("google")) {
      throw new Error("Health Connect is not installed");
    }
    await OpenWearablesHealthSDK.requestAuthorization(TYPES);

    if (!(await OpenWearablesHealthSDK.startBackgroundSync(90))) {
      throw new Error("Could not start sync");
    }
    setConnected(true);
  }

  return { connected, connect };
}

Getting started

Architecture

Health Scores

Providers

Open Wearables Mobile App

Mobile SDK

MCP Server

Developer Portal

Developer Guides

Configuration

Deployment

Support

React Native Health Data Integration

Configure on Every Launch

Select the Provider (Android)

Request Permissions

Start Background Sync

Logging

Disconnect

Expo and Bare React Native Setup

Complete Example

Next Steps

Troubleshooting

SDK API reference

​Configure on Every Launch

​Sign In

​Select the Provider (Android)

​Request Permissions

​Start Background Sync

​Logging

​Disconnect

​Expo and Bare React Native Setup

​Complete Example

​Next Steps

Troubleshooting

SDK API reference

Configure on Every Launch

Sign In

Select the Provider (Android)

Request Permissions

Start Background Sync

Logging

Disconnect

Expo and Bare React Native Setup

Complete Example

Next Steps