Guide
Connect your body data
Meridian learns from your sleep, steps, and resting heart rate through Apple Health. The email titled Your Meridian beta access code, which arrives right after your first sign-in to the app, contains everything you need: your personal sync code and the shortcut link.
What you need
- An iPhone.
- A wearable that writes to Apple Health: Garmin (via the Garmin Connect app), Coros (Coros app → Profile → Settings → 3rd Party Apps → Apple Health), Amazfit (Zepp app → Profile → Add accounts → Apple Health), or an Apple Watch (nothing to set up).
- Your personal sync code from your access-code email (sent right after your first sign-in). It looks like
mrd_…and it's yours alone.
Set up the sync
Add the shortcut. On your iPhone, tap the shortcut link in your access-code email. Safari downloads a small file; tap the download (the arrow icon next to the address bar), choose Open in "Shortcuts" if asked, then tap Add Shortcut.
Paste your code. When the Configure This Shortcut screen appears, paste your sync code into the empty field and continue. This is the only time you'll ever enter it.
Run it once by hand. Open the Shortcuts app and tap Meridian Beta Sync. The first run is the only chatty one: iOS guards your health data, so it checks with you before letting the sync read anything. Depending on your phone you'll see one, two, or three prompts. All are normal, each is answered once, and here is exactly what to do with each:
- "Meridian Beta Sync" would like to access your Health data → tap Turn On All, then Allow. The sync needs every reading it lists (Steps, Resting Heart Rate, Sleep); allowing only some leaves gaps in your mirror.
- "Shortcuts does not have access to your Steps (or Sleep) data" → access was declined at some point and iOS remembers. Open Settings → Privacy & Security → Health → Shortcuts, turn every category on, then run the shortcut again.
- "This action is trying to share [a number of] Health items, which is not allowed" → your phone keeps very detailed sleep records and iOS caps how much a shortcut may pass along. Open Settings → Apps → Shortcuts → Advanced, enable Allow Sharing Large Amounts of Data, then run again.
When a run ends with no message at all, everything worked: silence is success, and the questions never come back.
Make it automatic. Shortcuts app → Automation → New Automation → Time of Day → 09:00, daily → Run Immediately → choose Meridian Beta Sync.
That's it. Open Meridian and your recent days appear in Today and Analytics, labelled with their source.
How you know it's working
Silence is success. If a sync ever fails you'll get a notification starting with "Sync failed. Server said:" followed by the reason; screenshot it and send it to us. Missed a day because your phone was off? The next sync catches up your latest night on its own; for a longer gap, reply to your welcome email and we backfill it for you.
Privacy, plainly
The shortcut reads only steps, resting heart rate, and sleep from Apple Health, and sends them only to your own Meridian account over an encrypted connection. Your sync code identifies you and nothing else; if it ever leaks, tell us and we revoke it in seconds and issue a new one. Nothing is shared with third parties, ever. Full detail in our Privacy Policy.
Troubleshooting
- Lost your code? It's in your access-code email (subject: Your Meridian beta access code), or ask us and we'll resend it.
- Entered the wrong code? Long-press Meridian Beta Sync → Edit: the first block is a text box containing your code; correct it there.
- "Could not run Find Health Samples Where. Shortcuts does not have access to your Steps data" (or Sleep, or Heart Rate)? Health access was declined at some point; iOS remembers. Open Settings → Privacy & Security → Health → Shortcuts, turn on every category listed (Steps, Resting Heart Rate, Sleep), then run the shortcut again. One clean run and the questions stop.
- "This action is trying to share [some number of] Health items, which is not allowed"? iOS caps how much Health data a shortcut may pass along in one go, and phones with rich sleep records go over it. One-time fix: Settings → Apps → Shortcuts → Advanced → enable Allow Sharing Large Amounts of Data, then run again. The latest shortcut version reads a much smaller window, so most people never see this at all.
- No data appearing? Check Apple Health has data for those days (Browse → Steps / Sleep). The sync can only deliver what your wearable gave Apple Health.
- Changed phones? Reinstall from the same link, paste the same code.