Por qué pasa por Health Connect
Samsung Health no tiene una API en la nube a la que puedas conectarte, y el SDK de datos de Samsung solo está abierto a socios registrados. Lo que sí hace Samsung Health es sincronizarse con Health Connect en el teléfono, en ambos sentidos. Health Connect tampoco tiene una API web, así que una app en el teléfono lo lee y reenvía los datos. Más detalles en una API web para Health Connect o Apple Health.
Qué necesitas
- Un teléfono Android con Android 9 o posterior, Health Connect y Samsung Health. Vincula tu Galaxy Watch con Samsung Health para tener sus datos.
- Life Dashboard para Android. Está en Google Play por 4,99 € (4,99 USD), pago único, sin suscripción: la forma más cómoda, con actualizaciones automáticas, y al comprarla apoyas el desarrollo. Las vías gratuitas instalan la misma app con la misma clave de firma: el APK firmado de GitHub, Obtainium, que mantiene ese APK actualizado, y F‑Droid, que la compila a partir del código fuente.
- Un servidor que acepte un POST con JSON por HTTPS, con un límite de cuerpo de al menos 10 MB. El HTTP sin cifrar en tu propia red necesita Permitir webhooks con HTTP sin cifrar en Más > Avanzado.
Envía Samsung Health a un webhook
- En Samsung Health, ve a Ajustes > Health Connect, toca Get started, elige los datos y toca Permitir. La lectura y la escritura se conceden por separado.
- En la app Life Dashboard, en la pestaña Salud, toca Agregar destino (si todavía no hay nada configurado, Usar tu propio servidor), escribe tu URL en URL del webhook y toca Agregar webhook.
- En Secreto de firma HMAC (opcional), toca Generar y pon el mismo valor en tu servidor.
- Toca Guardar en la parte superior, abre otra vez la fila de la dirección en la pestaña y toca Enviar prueba.
- Toca Conceder y permite tus tipos de datos y la lectura en segundo plano. Activa los tipos que quieras en Qué enviar.
- Evita que Android detenga las sincronizaciones: Ajustes > Aplicaciones > Life Dashboard > Batería, elige Sin restricciones, y agrega Life Dashboard a Never sleeping apps en Ajustes > Batería > Límites de uso en segundo plano.
- Toca Sincronizar ahora. Para los datos más antiguos, toca Enviar historial en Qué enviar y elige hasta dónde retroceder, desde 30 días hasta Todo el historial.

Qué obtienes
De la lista de Samsung de lo que sincroniza con Health Connect, estos son los tipos que la app reenvía:
| Área | Tipos |
|---|---|
| Actividad | Pasos, sesiones de ejercicio, calorías totales y distancia del ejercicio, VO2 máx. del ejercicio |
| Sueño | Sesiones de sueño con sus fases |
| Corazón y sangre | Frecuencia cardíaca, presión arterial, glucosa en sangre, saturación de oxígeno |
| Cuerpo | Peso, grasa corporal, altura, tasa metabólica basal |
| Alimentación | Nutrición |
Cada petición es un POST con un objeto JSON. Abreviado, y sin el uuid y el source que lleva cada registro:
{
"timestamp": "2026-10-04T07:15:02.481Z",
"app_version": "1.23.0",
"source": "health_connect",
"sequence": 1842,
"daily_totals": [
{ "date": "2026-10-04", "steps": 1204, "distance_meters": 911.6 }
],
"sleep": [
{
"session_end_time": "2026-10-04T06:30:00Z",
"duration_seconds": 28800,
"stages": [
{ "stage": "deep", "start_time": "2026-10-03T23:00:00Z",
"end_time": "2026-10-04T01:00:00Z", "duration_seconds": 7200 }
]
}
]
}
Guarda los registros con uuid como clave, que sigue siendo el mismo cuando un registro se envía otra vez, y usa daily_totals para los pasos, la distancia y las calorías, así un paseo que cuentan el teléfono y el reloj se cuenta una sola vez. La referencia del payload documenta cada campo.
Qué se guarda Samsung
No están en la lista de Samsung, a octubre de 2026: el estrés, el ECG, el Energy Score, la variabilidad de la frecuencia cardíaca, la temperatura de la piel, la frecuencia respiratoria, la frecuencia cardíaca en reposo y el seguimiento del ciclo. Lo que Samsung Health comparte puede cambiar con cualquier versión, así que compruébalo en tu propio teléfono, en los permisos de aplicaciones de Health Connect para Samsung Health.
Una sincronización continua, no un archivo puntual
Esto no es un CSV con todo lo que Samsung Health guardó alguna vez. La primera sincronización envía los últimos 7 días, y cada sincronización posterior envía lo que es nuevo o cambió, cada 60 minutos de forma predeterminada o a horas fijas. Un backfill llega hasta donde Health Connect tenga datos. Tu receptor decide el formato: filas en Postgres, un archivo CSV o cualquier otra cosa.
Que tu historial anterior de Samsung Health esté en Health Connect depende de Samsung Health, y Samsung no lo dice. Su guía solo dice que, una vez que conectas los dos, se comparten los datos nuevos o actualizados. Para ver lo que tiene Health Connect, lanza un backfill con Todo el historial después de Conceder acceso al historial: envía todo lo que Health Connect tiene de los tipos que activaste, así que el día más antiguo que llega a tu receptor indica hasta dónde llegan tus datos.
Receptores que funcionan: el stack de Life Dashboard con Postgres y Grafana, un nodo Webhook de n8n, Node-RED o un script corto. La referencia del payload trae un receptor en Python y otro en Node.js para empezar.

Limitaciones
- Los datos del reloj llegan a Health Connect después de llegar al teléfono: cuando el reloj se vuelve a conectar, o cuando abres la pantalla de inicio de Samsung Health o deslizas hacia abajo en ella. Samsung retiene un tiempo la frecuencia cardíaca continua para ahorrar batería.
- Los datos de más de 30 días antes de que le dieras acceso a la app por primera vez necesitan el permiso de historial de Health Connect, que la página del backfill pide con Conceder acceso al historial.
Life Dashboard para Android
Activa Health Connect en Samsung Health, instala la app y toca Enviar prueba contra tu URL.
4,99 €, pago único, en Google Play: la forma más cómoda, con actualizaciones automáticas, y así apoyas el desarrollo.
O gratis, la misma app con la misma clave de firma: APK en GitHub · Obtainium · F‑Droid
Consigue la app para Android Referencia del payload
La app de código abierto para Android que usa esta guía. Sin cuenta y sin nube. Más sobre la app.
Preguntas frecuentes
¿Hay una API de Samsung Health a la que pueda llamar desde mi servidor?
Para tus propios datos, no. Samsung no tiene una API en la nube a la que puedas conectarte, y su SDK de datos es para socios registrados. Health Connect en el teléfono es la vía abierta.
¿Puedo obtener un archivo CSV?
Sí. Más > Exportar datos en la pestaña Salud comparte como CSV o JSON lo que enviaría la siguiente sincronización. Hacia tu servidor, los datos de salud salen de la app como JSON, y tu receptor también puede escribir CSV si lo quieres.
¿Puedo enviarlo también a Home Assistant?
Sí. Vincula la integración Life Dashboard, como en Samsung Health y Galaxy Watch en Home Assistant, y cada payload va a los dos. Cuenta como entregado en cuanto uno de ellos lo acepta, así que un destino que esté caído en ese momento se lo pierde.