¿Cómo envío los datos de Health Connect a mi propio webhook como JSON?

Life Dashboard para Android, una app de código abierto, lee Health Connect según un horario y envía cada registro nuevo a las URL que introduces, como un POST por HTTPS con un cuerpo JSON. Cada payload contiene los registros de los tipos que activaste (34 en total, desde los pasos y las fases del sueño hasta la frecuencia cardíaca, el peso y la presión arterial), cada uno con un uuid estable y la app que lo escribió, además de totales diarios que cuentan un paseo una sola vez.

Con un secreto definido, cada petición va firmada con HMAC-SHA256 en un encabezado X-Signature, y los payloads que no se pueden entregar esperan en una cola de salida en el teléfono hasta la siguiente sincronización. Sirve cualquier receptor que acepte JSON, entre ellos n8n, Node-RED, un script pequeño o el stack Life Dashboard con Postgres y Grafana.

Por Owen Vogelaar, que mantiene Life Dashboard 8 min de lectura

Consigue la app para Android

Por qué hace falta una app en el teléfono

Health Connect no tiene API web. Es un almacén en el teléfono que las apps leen a través de Android, así que algo en el teléfono tiene que leerlo y reenviarlo. La app Life Dashboard hace eso y envía directamente a tu URL, sin ningún servicio en la nube ni cuenta de Google de por medio. Un solo payload contiene todas las fuentes: lo que Samsung Health, Google Health (Fitbit y Pixel Watch), Garmin Connect, Oura y Withings escriben en Health Connect, con cada registro etiquetado con la app que lo escribió. La ruta en la nube de Google, la Google Health API, necesita un proyecto de Google Cloud y un cliente OAuth, y solo ve lo que llega a tu cuenta de Google.

Qué necesitas

  • Android 9 o posterior con Health Connect, y una app que escriba en él, como Samsung Health, Garmin Connect o Google Health.
  • Life Dashboard para Android, desde Google Play por 4,99 €, pago único, o gratis desde GitHub Releases, Obtainium o F‑Droid. Las opciones de instalación enumeran todas las vías.
  • Un servidor que acepte un POST con JSON por HTTPS, con un límite de cuerpo de al menos 10 MB. Para HTTP sin cifrar en tu propia red hay que activar Permitir webhooks con HTTP sin cifrar en Más > Avanzado.

Envía Health Connect a tu propio servidor

  1. En la pestaña Salud, toca Agregar destino (si aún no hay nada configurado, Usar tu propio servidor), pega tu URL en URL del webhook y toca Agregar webhook. La pestaña Tiempo de pantalla tiene su propia lista.
  2. La dirección se abre en una página propia. Opcional: agrega un encabezado Authorization o una clave de API en Encabezados.
  3. En Secreto de firma HMAC (opcional), toca Generar y pon el mismo valor en tu servidor. Cada dirección tiene su propio secreto, así que un segundo servidor recibe el suyo.
  4. Toca Guardar arriba, abre otra vez la fila de la dirección en la pestaña y toca Enviar prueba para comprobar que tu servidor acepta la petición.
  5. Concede los permisos de Health Connect y toca Sincronizar ahora. Enviar historial, en Qué enviar, envía desde 30 días hasta 5 años, o Todo el historial.
Un destino de webhook en la app para Android, con su secreto de firma HMAC y sus encabezados

Cómo es el POST

Cada petición es un POST con Content-Type: application/json; charset=utf-8. Un payload de sincronización con pasos y frecuencia cardíaca, abreviado:

{
  "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,
      "active_calories": 58.2,
      "total_calories": 702.9
    }
  ],
  "steps": [
    {
      "uuid": "eb52b2c4-e3f7-49f3-8f92-34ca86640305",
      "source": "com.fitbit.FitbitMobile",
      "count": 412,
      "start_time": "2026-10-04T06:00:00Z",
      "end_time": "2026-10-04T07:00:00Z"
    }
  ],
  "heart_rate": [
    {
      "uuid": "708a76cb-45d3-45ea-9f8b-26d6d55d2692#1791097080000",
      "source": "com.fitbit.FitbitMobile",
      "bpm": 61,
      "time": "2026-10-04T06:58:00Z"
    }
  ]
}

El source de un registro es el nombre de paquete de la app que lo escribió. La referencia del payload documenta cada tipo, y un JSON Schema te permite validar lo que llega.

Comprueba la firma

Con un secreto definido, cada petición lleva X-Signature: sha256=<hex>, el HMAC-SHA256 del cuerpo en bruto. Usa el secreto como texto UTF-8, sin decodificarlo, y calcula el HMAC sobre los bytes tal como llegaron, antes de interpretarlos. Compara en tiempo constante y responde 401 si no coincide:

expected = "sha256=" + hmac.new(SECRET, body, hashlib.sha256).hexdigest()
valid = hmac.compare_digest(expected.encode(), presented.encode())

Para un proxy inverso que exige un certificado de cliente, instálalo en la configuración de Android y elígelo en Más > Avanzado > Certificado de cliente (mTLS).

Reintentos, cola de salida y borrados

  • Reintentos. Cualquier 2xx cuenta como entregado. Un tiempo de espera agotado, un error de red, un 408, un 429 o un 5xx recibe 3 intentos. Un 400, un 413 o un 422 no se reintenta: la app vuelve a ofrecer ese payload en cada sincronización durante una semana y después lo descarta, mientras los payloads posteriores salen como siempre. La app espera 10 segundos como máximo, así que responde primero y guarda después.
  • Cola de salida. Un payload fallido se queda en el teléfono y sale el primero en la siguiente sincronización. La cola de salida admite hasta 700 payloads de Health Connect, una semana de sincronizaciones cada 15 minutos. Después de un 401 o un 404, los payloads posteriores esperan hasta que corrijas la configuración y entonces llegan en orden.
  • Duplicados y payloads tardíos. Un registro puede volver a llegar después de un reintento o en un backfill, el envío de todo tu historial anterior, así que guarda los registros con uuid como clave. Un payload que esperó en la cola de salida, o uno que tu receptor rechazó y recibe otra vez más tarde, puede llegar después de uno más reciente y aun así contiene registros que ningún payload posterior repite: aplica también sus registros. Usa sequence, que solo aumenta, únicamente para resolver conflictos: un registro que un payload con un número más alto nombró en deleted_records sigue borrado, y los daily_totals de una fecha vienen del payload con el número más alto que traía esa fecha.
  • Borrados. Un registro borrado en Health Connect aparece en el deleted_records del siguiente payload, con su type y su uuid. El seguimiento empieza cuando la app sincroniza un tipo por primera vez, y un tipo del que el teléfono no puede responder en una sincronización aparece en deletions_unavailable; concilia esos con un backfill.

Receptores que funcionan

  • El stack Life Dashboard. Imágenes publicadas de un receptor que comprueba X-Signature, Postgres y Grafana con seis dashboards, instalados desde un solo archivo compose o con un chart de Helm. Escanea su código QR de vinculación en la app, o apunta la app a http://<host>:8080/webhook/<label>. Consulta el stack Life Dashboard.
  • n8n. Un nodo Webhook con Raw Body activado, una comprobación de la firma y un nodo Respond to Webhook que responde 204 o 401. Health Connect a n8n tiene el workflow completo, y la referencia del payload tiene los pasos con un nodo Crypto.
  • Node-RED. Un nodo http in con Do not parse request body activado (Node-RED 4.1 o posterior) entrega los bytes en bruto para el HMAC.
  • Home Assistant. La integración Life Dashboard convierte el payload en sensores y estadísticas a largo plazo.
  • InfluxDB o cualquier otra cosa. No hay un receptor ya hecho para InfluxDB, así que escribe un script pequeño. La referencia del payload tiene un receptor en Python y otro en Node.js como punto de partida.

Guárdalo en Postgres

Sea lo que sea lo que recibe el POST, n8n o un script, el patrón de almacenamiento es el mismo:

  • Haz un upsert de cada registro con su clave del payload y su uuid, en una columna text. Las muestras de frecuencia cardíaca y de temperatura de la piel llevan un # y una hora después del ID del registro, así que no es un uuid de Postgres.
  • Guarda daily_totals como una fila por fecha, que solo sustituye un payload con un sequence más alto: el de hoy es un total acumulado.
  • Borra lo que nombra deleted_records, por type y uuid. Para un registro de frecuencia cardíaca o de temperatura de la piel, borra todas las muestras cuyo uuid empiece por ese uuid y un #.

El receptor de el stack Life Dashboard hace las tres cosas, si prefieres no montarlo tú mismo, y devuelve el resultado mediante una API de solo lectura. Una vez que los datos están en Postgres, un modelo que tú eliges puede leerlos mediante un servidor MCP de solo lectura: Health Connect y Apple Health por MCP cubre el servidor del propio stack y uno para un Postgres tuyo.

La app para iPhone envía el mismo payload

Life Dashboard para iPhone envía los datos de Apple Health con las mismas claves, las mismas unidades y la misma firma, y con "source": "healthkit_ios", así que un solo receptor acepta los dos teléfonos. Envía el mismo contador sequence, y su HRV es SDNN donde Android envía RMSSD, así que mantén las dos separadas. Está en App Store por 6,99 € (5,99 USD), pago único, sin suscripción. Compilarla a partir del código fuente con Xcode no cuesta nada más si ya tienes una suscripción al Apple Developer Program. Consulta cómo conseguirla.

Limitaciones

  • Con varias URL, un payload cuenta como entregado cuando una lo acepta, y las demás no lo reciben otra vez. La pestaña Logs muestra cada resultado.
  • 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 pide la página del backfill.

Life Dashboard

Instala la app, apúntala a tu URL y toca Enviar prueba. La referencia del payload tiene cada campo y un receptor en Python y en Node.js.

Disponible en Google Play

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

Descárgala en App Store

6,99 €, pago único, en App Store, sin suscripción.

Compilar con Xcode

Consigue la app para Android Referencia del payload

Las apps de código abierto que usa esta guía, para Android y iPhone. Sin cuenta y sin nube. Más sobre Android y iPhone.

Preguntas frecuentes

¿Puedo usar la Google Health API en su lugar?

Para los datos de tu cuenta de Google, como los de Fitbit y Pixel Watch, Google ofrece la Google Health API en su nube, que necesita un proyecto de Google Cloud y un cliente OAuth. Health Connect en sí no tiene API web. La app Life Dashboard lo lee en el teléfono, así que los datos de Samsung Health, Garmin Connect, Oura y Withings llegan en el mismo payload, y nada pasa por una cuenta de Google por el camino.

¿Puedo ver un payload real antes de escribir un receptor?

Sí. Vista previa del payload, en Qué enviar dentro de la pestaña Salud, muestra lo que enviaría la siguiente sincronización, y Más > Exportar datos lo comparte como CSV o JSON.

¿Envía también el tiempo de pantalla?

Sí, como un payload aparte con "source": "screen_time", con los minutos por app y por día de los últimos 7 días. Consulta tiempo de pantalla por app.

¿Cómo evito contar los pasos dos veces?

Usa daily_totals para los pasos, la distancia y las calorías. Al sumar los registros en bruto, un paseo se cuenta una vez por cada dispositivo que lo registró.

¿Hay una exportación a 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 los guarda en el formato que quiera.