¿Cómo envío los datos de Apple Health a un webhook automáticamente?

Instala la app Life Dashboard en tu iPhone, agrega tu URL con Agregar destino en la pestaña Salud y elige en Qué enviar los tipos de Apple Health (la app Salud del iPhone) que quieres enviar. A partir de ahí la app lee Apple Health en segundo plano según el horario que definas y envía cada registro nuevo a tu URL como JSON: pasos, sueño con sus fases, frecuencia cardíaca, HRV, peso, presión arterial, entrenamientos y más, 28 tipos en total, cada registro con un uuid estable y la app o el dispositivo que lo escribió.

Con un secreto definido, cada petición va firmada con HMAC-SHA256 en un encabezado X-Signature. Un payload que no se puede entregar espera en una cola en el iPhone, y un registro que borras en Apple Health aparece nombrado en el siguiente payload. El payload es el de la app para Android, así que un solo receptor acepta por igual un iPhone y un teléfono Android.

iPhone o Apple WatchApple HealthApp Life DashboardTu URL

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

Consigue la app para iPhone

Por qué hace falta una app en el iPhone

Apple Health no tiene API web. Vive en el iPhone, y las apps lo leen a través de HealthKit de Apple, así que algo en el iPhone tiene que leerlo y reenviarlo. La app Life Dashboard hace eso y envía directamente a las URL que introduces. No hay cuenta ni ningún servidor de Life Dashboard de por medio, y la app no tiene analíticas, informes de fallos ni anuncios. Una API web para Health Connect o Apple Health lo explica con más detalle.

Qué necesitas

  • Un iPhone con iOS 17 o posterior, y Life Dashboard para iPhone. 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.
  • Un servidor que acepte un POST con JSON. Usa https://. iOS solo permite http:// sin cifrar hacia una dirección IP, un nombre .local o un nombre sin punto, pensado para tu propia red.

Configuración paso a paso

  1. En la configuración inicial de la app, introduce tu URL como URL del webhook. Más adelante, toca Agregar destino en la pestaña Salud, introdúcela y toca Agregar webhook. Puedes agregar varias; una sincronización cuenta como entregada cuando una de ellas la acepta.
  2. Opcional: toca el destino en la pestaña Salud. En Encabezados personalizados, toca Agregar un encabezado para un encabezado Authorization o una clave de API. Introduce un Secreto de firma HMAC que tu servidor también conozca, o toca Generar y Copiar secreto. Después toca Guardar. Cada dirección tiene su propio secreto y sus propios encabezados.
  3. Toca Ping de prueba en la configuración inicial, o Enviar prueba en la hoja del destino. Envía un payload pequeño con "test": true y sin registros, usando lo que está guardado. Si tu servidor está en casa, permite Red local cuando iOS lo pida.
  4. En Qué enviar, activa tus tipos y permite el acceso a Apple Health. Ahí mismo, Vista previa del payload muestra los últimos 7 días tal como quedaría el payload, y Sincronizar ahora, en la pestaña Salud, envía lo nuevo. La primera sincronización de un tipo envía sus últimos 7 días.
  5. 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.
Un destino de webhook en la app para iPhone, con su secreto de firma y sus encabezados personalizados

Cómo es el POST

Cada petición es un POST con JSON. Un payload abreviado, de la página del payload de iOS:

{
  "timestamp": "2026-02-05T12:00:00Z",
  "timezone": "Europe/Amsterdam",
  "app_version": "1.9.0",
  "source": "healthkit_ios",
  "sequence": 42,
  "steps": [
    {
      "count": 1234,
      "start_time": "2026-02-05T08:00:00Z",
      "end_time": "2026-02-05T09:00:00Z",
      "uuid": "5B7A0C2E-8F3D-4B1A-9C6E-2D4F8A1B3C5D",
      "source": "Alex's iPhone"
    }
  ],
  "daily_totals": [
    { "date": "2026-02-05", "steps": 8421, "distance_meters": 6210.4 }
  ]
}
  • source, en el nivel superior, es healthkit_ios, donde la app para Android dice health_connect.
  • timezone es la zona horaria del iPhone en el momento en que se creó el payload. Todas las horas del payload están en UTC, y esta es la zona con la que daily_totals corta sus días, así que un receptor sabe cuál es el día local después de un cambio al horario de verano o de un viaje. Todos los payloads la llevan desde la versión 1.9.0.
  • sequence sube de uno en uno con cada payload que crea el iPhone, y un reintento conserva el número con el que se creó.
  • Cada registro tiene un uuid, el de la propia muestra de Apple Health, que no cambia en toda la vida del registro, y un source: el nombre que Apple Health da a la app o al dispositivo que lo escribió. Para los datos que registra el propio iPhone o el reloj, es el nombre del dispositivo, que a menudo incluye el nombre de su propietario.
  • daily_totals contiene los pasos, la distancia y las calorías por día local, para hoy y los dos días anteriores, calculados con las estadísticas propias de Apple Health. Un paseo registrado tanto por el iPhone como por el reloj cuenta ahí una sola vez; al sumar los registros en bruto se cuenta dos veces.

Las claves, los campos y las unidades son los de la app para Android. La referencia del payload de la app para Android documenta cada tipo, y su JSON Schema cubre las dos apps. Tipos de datos de Apple Health enumera lo que envía un iPhone, clave por clave.

Comprueba la firma

Con un secreto definido, cada POST lleva X-Signature: sha256=<hex>, el HMAC-SHA256 del cuerpo en bruto de la petición con tu secreto como clave. Es el esquema de la app para Android, así que una sola comprobación sirve para los dos teléfonos. Calcúlalo sobre los bytes tal como llegaron, antes de interpretarlos, compara en tiempo constante y responde 401 si no coincide. En Node.js:

const crypto = require('crypto');

function verifySignature(req, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(req.rawBody) // the exact raw request body bytes
    .digest('hex');
  const actual = req.get('X-Signature') || '';
  return actual.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(actual), Buffer.from(expected));
}

En Python:

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

Para un servidor detrás de un proxy inverso que exige un certificado de cliente, impórtalo como archivo .p12 en Más > Avanzado. Se queda en el Llavero del iPhone, y lo recibe cada webhook cuyo servidor pide un certificado, también en segundo plano.

Los reintentos y la cola

  • Reintentos. Cualquier 2xx cuenta como entregado. Un error de red, un tiempo de espera agotado, un 408, un 429 o un 5xx se intenta hasta 3 veces en total, con 1 y luego 2 segundos de separación. Otros errores, como 401 o 404, fallan al momento. Un intento se abandona cuando la conexión lleva 10 segundos parada, así que responde primero y guarda después.
  • La cola. Cada payload entra en la cola del iPhone antes de enviarse, así que una sincronización que iOS corta a medias no pierde nada. Uno que no se entregó vuelve a salir cuando regresa la red, en la siguiente sincronización o con Reintentar ahora, el más antiguo primero, a las URL y con los encabezados configurados en ese momento. La cola se detiene en el primer payload que falla, así que el resto conserva su orden.
  • Payloads rechazados. Un payload que tu servidor rechaza con 400, 413 o 422 no retiene a los que van detrás. Se queda en la cola y se vuelve a ofrecer una vez al día. Los payloads que entraron en la cola después pueden entonces llegar antes: usa sequence para resolver el orden.
  • Payloads antiguos y descartados. Un payload de más de 7 días se descarta cuando tu servidor responde con un error a su siguiente entrega, nunca mientras el iPhone está sin conexión. La cola admite hasta 700 payloads; pasado ese número, se va el más antiguo. Cada payload descartado recibe una fila en la pestaña Logs y una notificación.
  • Las redirecciones solo se siguen dentro del mismo host. Una redirección a otro host, como una página de inicio de sesión delante de tu servidor, cuenta como una entrega fallida, y el log nombra el host al que apuntaba.
La pestaña Logs de la app para iPhone, con una fila por entrega

Registros borrados

Un registro borrado en Apple Health no deja nada que una sincronización pueda leer, así que la app sigue el registro de borrados del propio Apple Health y nombra lo que ya no está en el siguiente payload, con la clave bajo la que llegó el registro y el uuid con el que se entregó:

"deleted_records": [
  { "type": "nutrition", "uuid": "84E37E8A-1C2D-4E5F-8A9B-0C1D2E3F4A5B" }
]
  • Cuando un borrado es el único cambio, la sincronización envía un payload con deleted_records y sin registros.
  • Apple Health nunca edita un registro en el sitio. Una app que edita uno lo borra y guarda otro nuevo con un uuid nuevo, así que una edición llega como un borrado más un registro nuevo.
  • Un borrado de sueño nombra una fase, no la noche. Quita esa fase, o sustituye las noches que cubre un payload más reciente.
  • deletions_unavailable enumera las claves de las que un payload no puede responder, por ejemplo cuando Apple Health no contestó a tiempo o un tipo llevaba más de 7 días sin leerse. Concilia esas con un backfill, el envío de todo tu historial anterior.

Cuándo envía

En Cuándo enviar, define un intervalo de 15 minutos o más, 60 de forma predeterminada, u horas fijas del día, en los días que elijas, con horas de silencio. iOS decide cuándo se ejecuta una app en segundo plano, así que una hora fija significa "no antes de". Apple Health también despierta la app cuando un tipo activado tiene datos nuevos, como mucho con la frecuencia que Apple permite para ese tipo. La actualización en segundo plano tiene que estar activada para la app; el modo de bajo consumo la desactiva.

Para una sincronización en un minuto exacto, crea una automatización de Atajos que ejecute Sincronizar datos de salud a esa hora. La misma acción funciona al llegar a casa, por voz con Siri, desde el widget de la pantalla de inicio y desde un control del Centro de control en iOS 18 y posteriores. Envía lo que está en la cola y lo nuevo.

iOS cifra Apple Health mientras el iPhone está bloqueado, así que una sincronización que empieza en ese momento espera al desbloqueo.

Cuándo enviar en la app para iPhone, a horas fijas con horas de silencio

Backfill

Enviar historial, en Qué enviar, envía el periodo que elijas, desde 30 días hasta todo el historial, en ventanas de 3 días, la más antigua primero, con los campos backfill, window_start, window_end y window_complete. Los registros son los mismos que envía una sincronización, uuid incluido, así que lo que se solapa se deduplica. window_complete es siempre false desde un iPhone, porque Apple Health no le dice a una app qué tipos no puede leer. Los payloads de backfill van solo a los webhooks, nunca a MQTT ni a la cola.

Receptores que funcionan

  • El stack Life Dashboard. Un receptor que comprueba X-Signature, Postgres y dashboards de Grafana, desde un solo archivo compose. Escanea su código QR de vinculación en la app. Consulta el stack Life Dashboard.
  • n8n. Un nodo Webhook con Raw Body activado, una comprobación de la firma en un nodo Code y un 204. Apple Health a n8n tiene el workflow.
  • 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.
  • Un script tuyo. La referencia del payload de Android tiene receptores de ejemplo en Python y Node.js.

Guárdalo

  • Haz un upsert de cada registro con su clave del payload y su uuid. Un registro puede llegar dos veces: un backfill vuelve a enviar su intervalo, y una entrega que iOS cortó se envía otra vez desde la cola. Una misma muestra de energía activa cuenta tanto para active_calories como para total_calories, así que usa las dos cosas como clave.
  • Guarda daily_totals como una fila por fecha, tomada del payload con el sequence más alto que traía esa fecha.
  • El uuid de una noche de sueño viene de su fase más temprana, así que no cambia mientras la noche crece: sustituye la noche cuando vuelva más larga.
  • Borra lo que nombra deleted_records, por type y uuid, e ignora un uuid que no tengas.

En qué se diferencia un payload de iPhone del de Android

  • La variabilidad de la frecuencia cardíaca (HRV) es SDNN, la medida que guarda Apple Health. Android envía RMSSD bajo la misma clave; no son el mismo número.
  • El type de un entrenamiento es un nombre como running o hiit; Android envía un número como cadena.
  • Las fases del sueño incluyen in_bed, el tiempo en la cama alrededor de las fases, que solo envía un iPhone.
  • No hay payload de tiempo de pantalla ni bloque _diagnostics.

Un receptor escrito para Android funciona sin cambios, siempre que trate esas diferencias como opcionales. La página del payload de iOS enumera todas las diferencias.

Life Dashboard para iPhone

Instala la app, agrega tu URL y toca Ping de prueba. La página del payload de iOS enumera todo lo que envía un iPhone.

Descárgala en App Store

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

Compilar con Xcode

Consigue la app para iPhone Referencia del payload de iOS

La app de código abierto para iPhone que usa esta guía. Sin cuenta, y los datos solo van adonde tú indiques. Más sobre la app.

Preguntas frecuentes

¿Puedo exportar Apple Health automáticamente, sin abrir la app?

Sí. Una vez configurada, la app sincroniza en segundo plano según tu horario, y Apple Health la despierta cuando hay datos nuevos. El iPhone tiene que estar desbloqueado para que una sincronización lea Apple Health, e iOS elige el momento exacto. Para un minuto fijo, usa una automatización de Atajos con Sincronizar datos de salud.

¿Puedo ver el JSON antes de escribir un receptor?

Sí. Vista previa del payload, en Qué enviar, muestra los últimos 7 días como un payload, Copiar JSON lo pone en el portapapeles y Compartir lo entrega como un archivo .json. Exportar datos, en Más, guarda lo mismo con Exportar JSON, o con Exportar CSV como una fila por registro.

¿Cómo evito contar los pasos dos veces?

Usa daily_totals para los pasos, la distancia y las calorías. Se cuentan como los cuenta la app Salud, así que un iPhone y un reloj que registraron el mismo paseo lo cuentan una sola vez.

¿Sirve el mismo receptor para un teléfono Android?

Sí. Las dos apps envían las mismas claves, las mismas unidades y la misma firma. Distínguelas por el source de nivel superior: healthkit_ios o health_connect. Health Connect a un webhook cubre la parte de Android.

¿Envía la app algo al desarrollador?

No. La app no tiene analíticas, informes de fallos ni anuncios, y no hay ningún servidor de Life Dashboard. Los datos van solo a las URL, al broker o al Home Assistant que tú configures.