Ultrahuman

ioBroker.ultrahuman

Current adapter version: 0.1.13

Ultrahuman Ring Adapter for ioBroker

This adapter reads health metrics from your Ultrahuman Ring via the Ultrahuman Partner API and creates ioBroker objects you can use in visualizations, scripts, and automations.

Detailed guide (German): Ultrahuman Ring im ioBroker – Schlaf, HRV & Gesundheitsdaten (SmarterPapa.de) — installation, all data points, automation examples, FAQ.

Source code: GitHub

Maintainers: Enable Trusted Publishers for iobroker.ultrahuman (this GitHub repo). Releases use ioBroker/testing-action-deploy@v1 on Node.js 24 with OIDC only (no npm-token). See testing-action-deploy#19.

Installation

Install the adapter via the ioBroker Admin interface:

Open Adapters in ioBroker Admin
Search for ultrahuman
Click Install

Available metrics

Channel	State	Description	Unit
`sleep`	`bedtimeStart`	Time you went to bed	ISO 8601
`sleep`	`bedtimeEnd`	Time you got up	ISO 8601
`sleep`	`timeInBed`	Total time in bed	min
`sleep`	`timeAsleep`	Total time asleep	min
`sleep`	`timeToFallAsleep`	How long it took to fall asleep	min
`sleep`	`sleepEfficiency`	Sleep efficiency	%
`sleep`	`sleepScore`	Sleep score
`sleep`	`sleepQuality`	Sleep quality (excellent/good/fair/poor)
`sleep`	`remSleep`	REM sleep duration	min
`sleep`	`deepSleep`	Deep sleep duration	min
`sleep`	`lightSleep`	Light sleep duration	min
`sleep`	`restorativeSleep`	Restorative sleep (REM + deep)	%
`sleep`	`sleepCycles`	Full sleep cycles
`heart`	`restingHR`	Resting heart rate (sleep)	bpm
`heart`	`nightRHR`	Night resting heart rate	bpm
`heart`	`lastReading`	Last HR reading	bpm
`heart`	`avg` / `min` / `max`	Heart rate statistics	bpm
`heart`	`trend`	Heart rate trend
`hrv`	`average`	Average HRV	ms
`hrv`	`sleepHRV`	Average sleep HRV	ms
`hrv`	`min` / `max`	HRV statistics	ms
`hrv`	`trend`	HRV trend
`spo2`	`avg` / `min` / `max`	Blood oxygen statistics	%
`temperature`	`lastReading`	Last skin temperature	°C
`temperature`	`avg` / `min` / `max`	Temperature statistics	°C
`activity`	`steps`	Total steps today	steps
`activity`	`stepsAvg`	Average steps	steps
`activity`	`activeMinutes`	Active minutes	min
`activity`	`movementIndex`	Movement index
`activity`	`recoveryIndex`	Recovery index
`activity`	`vo2Max`	VO2 max	ml/kg/min
`info`	`connection`	API connection status	boolean
`info`	`lastUpdate`	Last successful update	ISO 8601

Prerequisites

You need access to the Ultrahuman Partner API:

Send an email to feedback@ultrahuman.com and request API access for personal use.
You will receive an API Key and an Access Code.
In the Ultrahuman app, go to Profile > Settings > Partner ID and enter the Access Code.
Configure the API Key and your account email in the adapter settings.

Configuration

Setting	Description	Default
API Secret	Your Ultrahuman Partner API authorization key	—
User Email	Email address linked to your Ultrahuman account	—
Polling Interval	How often to fetch data (minutes)	30

The minimum polling interval is 5 minutes. Since ring data syncs periodically (not in real-time), 30 minutes is recommended.

Support

If you find this adapter useful, consider supporting the development:

Acknowledgments

API integration based on ultrahuman-dashboard by Matt Krainski (MIT License).

Changelog

0.1.13 (2026-04-11)

Deploy uses Node.js 24 with testing-action-deploy@v1; Trusted Publishing only (no npm-token), per maintainer note on testing-action-deploy#19

0.1.12 (2026-04-10)

0.1.12: testing-action-deploy@v1 with npm-token again (OIDC-only path breaks on ubuntu-latest during global npm upgrade); README documents W3019 trade-off
common.news trimmed to seven entries (W1032); 0.1.3 moved to history only via CHANGELOG_OLD.md

0.1.11 (2026-04-09)

GitHub Releases: ioBroker/testing-action-deploy@v1 with granular NPM_TOKEN (Bypass 2FA)
Changelog lists 0.1.11 here; older releases in CHANGELOG_OLD.md
Dependabot default cooldown 7 days; includes 0.1.9–0.1.10 fixes (integration tests, Admin jsonConfig)

0.1.8 (2026-03-27)

io-package.json common.news reduced to 7 entries (ioBroker repository checker W1032)

0.1.7 (2026-03-26)

Package homepage (npm) points to the detailed German blog guide on SmarterPapa.de
README and ioBroker Admin (About tab) link to the same article; GitHub remains the repository URL

Older versions: CHANGELOG_OLD.md.

License

MIT License — see LICENSE for details.