Browse the guides

Apple Health Integration

Apple Health is the only outside integration Datum has — there's no separate account to create and no direct connection to a specific wearable brand. Datum only reads what your other apps (and whatever device they're connected to) have already written into Apple Health; it doesn't talk to an Apple Watch, Whoop, Garmin, or similar device directly.

Connecting#

In Settings, turn on the Apple Health toggle (see the Settings screenshot) and grant the permissions iOS asks for — you'll see Apple's own system permission sheet, not anything Datum builds itself. Turning it back off any time stops syncing. This step is entirely optional; skipping it just means Datum works as a self-contained app with no outside data.

Connecting also does a one-time catch-up: any workout you already finished before connecting gets synced right then too, not just workouts logged from that point on. Settings shows "Syncing past workouts..." while this runs, then how many were caught up.

What syncs, and in which direction#

Workouts (Datum → Apple Health): each finished workout is written to Apple Health as a workout entry, so it shows up alongside anything else you log there.

Calories & heart rate (Apple Health → Datum): Datum works out the calories for a workout itself, whether it's a strength session or a class or cardio activity. It never uses a calorie figure that another app (such as Whoop, Strava or Peloton) wrote to Apple Health. What it does use is an Apple Watch's own measured energy when there is one, and otherwise your heart rate during the workout from any source (a Watch, Whoop, or a Bluetooth chest strap connected to Datum, which saves its readings with the workout), plus your resting heart rate, age and bodyweight. The figure counts active calories only, the same way Apple Health's Active Energy does, so it leaves out what your body burns at rest.

Heart-rate data from a wearable often reaches Apple Health several minutes after your workout ends. So Datum calculates the figure fresh each time you open a workout in History instead of saving it when you finish. Earlier versions could save a figure that was far too low (the small movement energy your iPhone logs in your pocket). Those saved figures are ignored now, and the workout shows the recalculated one.

When the figure is an estimate, it is labelled Calories (estimate), with a note under it explaining what it was built from. Datum never stores an estimate or writes one back to Apple Health. Only an Apple Watch's measured energy is attached to the workout entry Datum writes.

Age. Datum reads your date of birth from Apple Health to estimate your maximum heart rate for the calorie estimate. It doesn't ask for your biological sex. Your date of birth is read on your iPhone, used in that calculation, and never stored by Datum or sent anywhere. If you'd rather not share it, decline. Apple Health doesn't even tell Datum you declined, and the estimate simply falls back to a method that doesn't need it.

Body metrics (both directions): weight, body fat %, and lean body mass sync both ways — see Body Metrics & Measurements for exactly what that looks like, including backfilling history from before you started using Datum.

Nutrition (Apple Health → Datum, read-only): calories, protein, carbs, fat, sugar, and water are imported from whatever app you use to log food (Datum doesn't have its own food-logging screen). This shows up in Reports' Nutrition section and in correlation reports — see Reports.

Activities#

Each logged class or cardio activity is written to Apple Health as its own workout entry, tagged with the right activity type (yoga, cycling, running, and so on) — separate from the strength workout entry for the rest of that session, if there was one. This means a single Datum session with an embedded activity (a treadmill warm-up before lifting, say) can produce two separate entries in the Health app rather than one blended one. That's deliberate: a single Apple Health workout can only carry one activity type, so folding a cardio warm-up into a strength workout's entry would misrepresent both what it was and the energy Apple's own Activity-ring accounting expects for it.

Live heart rate during an activity, and during a strength workout, can also come from a paired Bluetooth heart rate monitor rather than Apple Health — see Classes & Cardio Activities for both live sources.

Calories on the Reports screen. "Calories out" counts only the active and resting energy recorded by your iPhone and Apple Watch. Health merges overlapping figures from different apps by a priority list, and newly added apps usually sit at the top of it, so another app's calorie figure could otherwise win the day's total. Days without an Apple Watch can read low.

Deleting a synced workout#

Deleting a workout in Datum doesn't automatically remove it from Apple Health — the two are separate copies once written. If the workout you're deleting had synced to Health, Datum asks first whether you want it gone from there too (see History); the default is to leave your Health data alone, so nothing is ever removed from Health without you explicitly choosing "Delete from Health." An embedded session's activity gets deleted from Health the same way as its strength entry, in the same prompt.

Why some numbers might show up blank#

Datum never presents a guessed number as a measured fact. Heart rate is shown only when something actually recorded it — if you trained without a connected device, or you're testing in the iOS Simulator (which has no real sensors), that field stays empty rather than showing a made-up value. This is the intended, cautious behaviour, not a sync failure.

Calories are the one exception, and only because the figure is clearly marked. When an Apple Watch measured your energy, that's what you see. Otherwise Datum estimates it, in this order of preference. For a class or cardio activity, two more methods apply when there is no heart rate: the GPS distance, time and climbing of a tracked walk, run, hike or ride, and then a typical effort for that kind of activity.

  1. Your heart rate above your resting heart rate, together with your age and bodyweight. This is the most accurate method available.
  2. Your RPE (how hard the sets felt), bodyweight and how long you trained, when there is no heart rate.
  3. Bodyweight and duration alone, the roughest figure Datum will show.

How accurate is it? Checked against 91 strength workouts of one person whose own wrist tracker had measured the calories, the heart-rate estimate landed within about 11% at the median and within 30% for nine in ten, and came out about 4% high overall. That is one person's data, so treat your own figure as an estimate, not a measurement. Datum always rounds down, since a calorie number is the one people eat back.

If you've never logged a bodyweight, Datum can't scale any of these, so it shows nothing at all.