Forma
Browse the guide

Guide › Your data

Apple Health

What Forma reads and what stays on the phone.

Forma can read your weight, body fat and lean mass, and your daily activity, from Apple Health. If your smart scale writes to Health, its readings arrive in Forma without you typing anything. Forma only reads from Health. It never writes to it.

When to use it

  • You use a smart scale that writes your weigh-ins to Apple Health, and you want them to show up in Forma by themselves.
  • You track steps or daily activity elsewhere and want Forma to use them.
  • You want Forma to read sleep, heart-rate or heart-rate-variability readings from your watch to help plan training and recovery.
  • You want to change or stop what Forma reads.

Step by step

To connect

  1. Open Forma, then open Settings.
  2. Tap Devices.
  3. Tap Apple Health.
  4. Tap Allow Apple Health and choose what to share in the Health access screens that follow.

Once connected, the row says Connected and shows when Forma last synced. Weigh-ins from your scale arrive as they happen.

To read sleep, HRV and resting heart rate

  1. On the same Apple Health screen, find the section Sleep, HRV and resting heart rate.
  2. Tap Use sleep and heart data.
  3. Choose what to share in the Health screens that follow.

This part is separate from weight and body measurements. If your watch writes those readings to Health, Forma can use them to plan training and recovery. They stay on your phone and in your own iCloud backup.

To pull in new readings by hand

  1. On the Apple Health screen, tap Check now.

You rarely need this. New readings arrive on their own while you use the app.

Good to know

  • Readings from Health count as weigh-ins on the weight page, where the 7-day average is what matters. A single reading is one point.
  • On the Apple Health screen there is a switch, Pause reading from Health. While paused, Forma reads nothing new from Health. What is already on this phone stays. Unpause to read again.
  • You can also turn the connection off altogether in the Health app, under Settings > Health > Data Access & Devices > Forma.
  • If the status says no readings yet, either Forma's access is off in the Health app, or your scale or watch has not written readings to Health yet. Health does not tell apps which, so check both.
  • Activity can be granted separately. If the Apple Health screen offers Also allow activity, tap it to let Forma read daily activity too.
  • If sleep and heart readings still do not appear, a request has to be made from inside Forma: tap Use my watch data on the Overnight card on Today, or the Use sleep and heart data button on the Apple Health screen. Health shows its permission sheet only when an app makes such a request.

Something unclear or missing? Write to and say which page.