Samsung Health API integration

Samsung Health matters in proportion to Galaxy's market share, which in India and much of Asia is substantial. Galaxy Watch users are a meaningful population that a Fitbit-and-Oura-only integration misses entirely.

Access is the awkward part. Samsung's health SDK requires partner approval, and the terms have shifted more than once. Many Galaxy Watch users also write into Health Connect, which is frequently the more practical route to the same data on modern devices.

WearLink supports the SDK push path and normalises into the shared schema. If your Android app already integrates Health Connect, check what your Samsung users actually surface there before investing in a separate Samsung SDK path.

Connect a Samsung Health user

Two calls. The first mints a hosted connect URL for your end-user; the second reads the normalised summaries once they have authorised with Samsung Health. Subscribe a webhook to receive the same objects as they land.

# 1. Create a connect session for your end-user
#    The API key goes in X-WearLink-API-Key, not in Authorization.
curl -X POST https://wearlink.io/api/v1/connections/session \
  -H "X-WearLink-API-Key: $WEARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "'"$USER_ID"'", "provider": "samsung-health", "redirect_uri": "https://yourapp.com/connected"}'

# → { "connect_url": "https://wearlink.io/widget/connect?token=...", "expires_in": 3600 }
# Redirect the user there; they authorise samsung-health and land back on your redirect_uri.
# The token is scoped to that one user — it is safe to put in a browser URL.

# 2. Pull normalised data whenever you want
curl -H "X-WearLink-API-Key: $WEARLINK_API_KEY" \
  "https://wearlink.io/api/v1/users/$USER_ID/summaries?provider=samsung-health&days=7"

Samsung Health data available through WearLink

• Steps
• Heart rate
• Sleep
• Workouts

Webhook events you can subscribe to

• steps.created
• heart_rate.created
• sleep.created
• workout.created

Normalised families this provider feeds: Sleep, Heart Rate Variability, Heart Rate, Workouts, Steps & Daily Activity, Calories & Energy, Blood Pressure, Body Composition, Body & Skin Temperature, Respiratory Rate & SpO2, Nutrition & Energy Balance, Stress.

What makes the Samsung Health API hard to integrate directly

These are the things that turn an estimated one-week integration into a one-month one.