Skip to content
Kinni Support

troubleshooting

Troubleshoot health sync

Use this troubleshooting guide when Apple Health or Health Connect is not connected, import/export permissions need attention, or Kinni shows a health-sync error.

Use this guide when Apple Health or Health Connect does not connect, Kinni says permissions need attention, or import/export does not behave as expected.

  1. Open Profile.
  2. Under Connected apps & devices, tap Apple Health or Health Connect.
  3. Check Current status.
  4. Review Connection status, Workout access, Import access, Export access, Sync status, Last import, Last export, and any error message.

If Kinni says the platform is not available on this device, use the correct platform for your phone: Apple Health on iPhone and Health Connect on Android.

If Kinni shows Permissions need attention or missing import/export access:

  1. Tap Settings from the health connection screen.
  2. Open Kinni’s Apple Health or Health Connect permissions.
  3. Allow workout read access if you want Kinni to import history.
  4. Allow workout write access if you want Kinni to export completed sessions.
  5. Return to Kinni and use Sync now.

On Android, if Health Connect does not open Kinni permissions directly, open Health Connect App permissions and select Kinni.

Kinni may skip a health workout when:

  • the activity is not a supported running, treadmill running, or walking workout
  • the workout is summary-only and does not include detailed sample data
  • the workout was originally exported by Kinni, so importing it back would create a duplicate
  • Kinni cannot check the cloud copy yet and defers the import until cloud lookup succeeds

Use Sync now after permissions and network access are available.

Kinni may skip export when:

  • Auto-upload to Apple Health / Health Connect is turned off
  • export permission is not granted
  • the session came from the same health platform already
  • the session has no detailed records to export
  • the health platform returned an error during sync

Turn on Auto-upload, allow write access, then use Sync now.

If Kinni shows Health sync failed or says workouts were deferred until cloud lookup succeeds:

  1. Check your internet connection.
  2. Confirm you are signed in to Kinni.
  3. Return to the health connection screen.
  4. Tap Sync now.
  5. If the same error remains, include the exact message when asking for support.

Still need help?

If an article does not answer your question, open Kinni and use in-app support, or join the Kinni Discord community for help from the team and other runners.

Join Kinni Discord