What You'll Learn

Which health platforms and wearables Gymkee supports
How automatic activity syncing works in the background
What data gets imported from your wearable (type, duration, distance, calories, heart rate, etc.)
How to enable health permissions on iOS and Android
What happens when a synced activity duplicates a manual log
How source badges work
How to troubleshoot sync issues

Step-by-Step Guide

Supported Health Platforms

Gymkee syncs activities through two health platforms:

Platform	Available On	How It Works
Apple Health (HealthKit)	iOS (iPhone, iPad)	Your wearable writes data to Apple Health. Gymkee reads from Apple Health.
Google Health Connect	Android	Your wearable writes data to Health Connect. Gymkee reads from Health Connect.

Gymkee does not connect directly to wearable brands. Instead, it reads from the health platform on your phone. As long as your device writes data to Apple Health or Google Health Connect, Gymkee can import it.

Compatible Wearables

Any device that writes workout data to Apple Health or Google Health Connect works with Gymkee. This includes:

Apple Watch (all models)
Fitbit (Charge, Sense, Versa, Inspire, etc.)
Garmin (Forerunner, Fenix, Venu, Vivoactive, etc.)
Samsung Galaxy Watch (all models)
Whoop (all models)
Polar (Vantage, Grit X, Ignite, etc.)
Suunto (all models)
Amazfit (GTR, GTS, T-Rex, etc.)
COROS (Pace, Apex, Vertix, etc.)
Oura Ring
Xiaomi Mi Band / Smart Band
And many more

If your device has a companion app that syncs with Apple Health or Google Health Connect, it will work with Gymkee.

Enabling Health Permissions

Before Gymkee can sync your activities, you need to grant it permission to read health data.

On iOS (Apple Health):

Open the Settings app on your iPhone
Scroll down and tap Health
Tap Data Access & Devices
Find and tap Gymkee
Make sure Workouts is toggled on (this allows Gymkee to read your workout activities)
You can also enable other categories like Heart Rate, Active Energy, and Walking + Running Distance for richer data

Alternatively:

Open the Health app
Tap your profile picture (top right)
Tap Apps under Privacy
Tap Gymkee
Enable the relevant data types

On Android (Google Health Connect):

Open the Settings app
Search for or navigate to Health Connect
Tap App permissions
Find and tap Gymkee
Make sure Exercise (or Workouts) is enabled
Enable other categories as desired (Heart Rate, Distance, Calories, etc.)

After granting permissions, open Gymkee. It will begin syncing in the background.

How Automatic Syncing Works

Once permissions are set up, syncing happens automatically. Here is what to expect:

You complete a workout or activity wearing your device
Your device syncs the data to its companion app (e.g., Garmin Connect, Fitbit app)
The companion app writes the data to Apple Health or Google Health Connect
Gymkee reads the data from the health platform in the background
The activity appears in your Gymkee activity list

Timing: Syncing is not instant. There are three steps (device to companion app, companion app to health platform, health platform to Gymkee), and each has a slight delay. Most activities appear within a few minutes to an hour. Opening Gymkee can trigger a fresh sync.

No manual action needed: You do not need to tap a "sync" button. Gymkee periodically checks for new data and imports it automatically.

What Gets Imported

When an activity syncs from your wearable, Gymkee imports the following data (if available):

Data Point	Description
Activity type	The type of workout (running, cycling, swimming, etc.) mapped to Gymkee categories
Duration	How long the activity lasted
Distance	Total distance covered (for applicable activities)
Calories	Total active calories burned
Heart rate	Average and/or maximum heart rate
Pace / Speed	Average pace or speed (for running, cycling, etc.)
Elevation	Elevation gain (if recorded by the device)
Start time	When the activity started

The exact data depends on what your device records. A simple fitness tracker might only capture duration and heart rate, while a GPS-enabled sports watch captures distance, pace, elevation, and more.

Understanding Source Badges

Every activity on Gymkee shows a source badge indicating where the data came from:

Manual: You logged this activity by hand on Gymkee
Apple Watch: Imported via Apple Health from an Apple Watch
Garmin: Imported via Apple Health / Health Connect from a Garmin device
Fitbit: Imported via Health Connect from a Fitbit device
Samsung: Imported from a Samsung Galaxy Watch
Other wearable names: The badge matches the device that recorded the activity

The source badge helps you identify where each activity's data originated, which is useful when checking for duplicates or comparing data quality.

Handling Duplicates

If you manually log an activity on Gymkee and the same activity also syncs from your wearable, you may end up with two entries.

How to spot duplicates:

Two activities on the same day with similar times and durations
One has a "Manual" source badge, the other shows a device name

What to do:

Delete the manually logged version (tap it, then delete)
Keep the wearable version, which typically includes richer data (heart rate, GPS distance, etc.)

Prevention tips:

If you know your wearable will sync the activity, do not log it manually
Check your activity list after a workout before creating a manual entry
If your wearable's companion app is slow to sync with the health platform, wait a bit before manually logging

Activities That Only Come from Import

Some activity types on Gymkee cannot be logged manually. They can only appear through wearable sync or coach prescription:

Weight training: Because Gymkee's structured workouts already cover weight training with full exercise, set, and rep tracking

If you see an activity type marked as "import only" in the manual logging screen, this means it can only arrive through syncing from a wearable.

Tips

Grant all available health permissions, not just workouts. The more data types you enable (heart rate, distance, calories, steps), the richer your synced activities will be.
Open Gymkee after a workout to speed up syncing. While syncing happens in the background, opening Gymkee can trigger an immediate check for new data.
Make sure your wearable's companion app is synced first. If your Garmin Connect app has not pulled the workout from your watch yet, Gymkee will not find it in Apple Health or Health Connect either.
Keep one wearable as your primary source. If you wear multiple devices, you may get duplicate activities. Stick to one device per workout.
Check that your wearable writes to the health platform. Some companion apps require you to explicitly enable health platform sync in their settings (e.g., Garmin Connect > Settings > Health > Apple Health).

Common Mistakes

Expecting instant sync. The data flows through multiple steps (device to app, app to health platform, health platform to Gymkee). Allow a few minutes. If it has been more than an hour, troubleshoot.
Not granting permissions and wondering why nothing syncs. This is the number one issue. Check your phone's health settings to confirm Gymkee has read access.
Manually logging every activity even with a connected wearable. This creates duplicates. Trust the sync process. Only log manually if you are sure your wearable did not capture the activity.
Wearing two devices and getting double entries. If you wear an Apple Watch and a Garmin at the same time, both may write the same activity to Apple Health. Gymkee may import both.
Not syncing the companion app first. If your Fitbit app has not downloaded data from your Fitbit band yet, the data will not reach Health Connect, and Gymkee will not see it.

Troubleshooting

Problem: No activities are syncing at all

Why it happens: Gymkee does not have permission to read health data, or the permissions were revoked at some point.

How to fix it: Go to your phone's health settings and verify Gymkee has read access. On iOS: Settings > Health > Data Access > Gymkee. On Android: Settings > Health Connect > App permissions > Gymkee. Toggle permissions on. Then open Gymkee and wait a few minutes.

Problem: Activities sync from my phone but not from my wearable

Why it happens: Your wearable's companion app may not be writing data to the health platform. Some apps require you to enable this manually.

How to fix it: Open your wearable's companion app (Garmin Connect, Fitbit, etc.) and check its settings for health platform integration. Look for options like "Sync with Apple Health" or "Connect to Health Connect" and make sure they are enabled. After enabling, do a test workout and check if it appears in Apple Health / Health Connect first, then in Gymkee.

Problem: A synced activity shows the wrong activity type

Why it happens: Gymkee maps the activity type from the health platform to its own categories. Sometimes the mapping is not exact (e.g., "Functional Training" might map to "CrossFit" or "Other").

How to fix it: Synced activities cannot be edited on Gymkee. If the type mapping is wrong, the activity data (duration, calories, heart rate) is still accurate. Your coach can see the original activity type from the source badge.

Problem: Synced calories do not match my wearable's calories

Why it happens: Different devices use different algorithms to calculate calories. The value imported by Gymkee comes from what the health platform reports, which may differ slightly from what your wearable's own app shows.

How to fix it: Small differences are normal. The calorie value Gymkee shows is what was written to Apple Health or Health Connect by your device. If the difference is large, check that your body weight and profile are correctly set in your wearable's companion app.

Problem: I deleted a synced activity and now it re-appeared

Why it happens: Gymkee re-imports activities from the health platform during each sync cycle. If the activity still exists in Apple Health / Health Connect, it will be imported again.

How to fix it: To permanently remove a synced activity, delete it from the source. Open the Health app (iOS) or Health Connect (Android), find the workout, and delete it there. It will not re-sync to Gymkee.