Integrations/Apple Health (iPhone)
updated 2026-06-13
Integrations

Apple Health (iPhone)

Let an iPhone client share steps, sleep, heart rate, HRV and body metrics from Apple Health — connect once on their phone, then it keeps syncing.

Basic  Apple Health is the health hub on every iPhone — it already collects steps, sleep, heart rate and more from the phone, the Apple Watch and other apps. Connecting it shares those numbers with you automatically. This is an iPhone (iOS) feature; the Android equivalent is Health Connect.

What syncs

Once a client connects Apple Health, Protocol reads these daily numbers:

Steps Active energy Resting heart rate Heart-rate variability Weight Body fat VO₂ max Sleep

These are daily summaries — a day’s step total, that night’s sleep, the morning’s resting heart rate. Protocol doesn’t pull minute-by-minute samples or live heart rate, and it doesn’t import individual workouts; those stay logged the usual way.

How your client connects

The whole flow lives in your app, on the client’s phone — you can’t do it for them from the dashboard. Walk them through it once:

  1. Open your app → ProfileHealth Data.
  2. Tap Connect on the Apple Health card.
  3. iOS shows its own permission sheet — the client turns on the categories they’re happy to share and taps Allow. (They’re in full control here; Protocol only asks to read.)
  4. Done — the card shows Connected and the first sync runs. After that it tops up every time they open the app.
9:41Health Data
Apple Health ● Connected
Last synced 6 min ago
Steps
Sleep
Heart rate & HRV
Body metrics
Sync now
The client's Health Data screen — connected, with a "Sync now" button and the last-sync time.

When data arrives — and why it can lag

Apple Health data syncs while the client has your app open (and there’s a short cool-down so it doesn’t sync constantly). It catches up the moment they reopen the app, and the Sync now button forces an immediate refresh. The practical takeaway: numbers are as fresh as the client’s last app open — a client who hasn’t opened the app in three days will have three-day-old data until they do.

First connection backfills history. The very first sync pulls roughly the last 30 days, so you get a trend immediately, not a blank chart you have to wait to fill.

“Connected” but no data showing?

iOS keeps health permissions private — it tells the app the permission screen was shown, but never whether the client actually left a category switched on. So the card can read Connected even if the client tapped through without enabling anything, and you’d see empty cards.

If a connected client shows No data available, have them check the toggles:

  • On the phone: Settings → Health → Data Access & Devices → [your app] and make sure the metrics you want are turned on, then Sync now in the app.

Turning it off

There’s no “disconnect” button on the device card. To stop sharing, the client revokes access from iOS Settings → Health → Data Access & Devices → [your app] (turn categories off, or remove access). New data stops flowing; what already synced stays on their profile.


Next: the Android equivalent — Health Connect →, or jump to Reviewing a client’s biometrics →.