App Permissions

How to resolve permission issues with syncing metrics and activities

On this page:

1. Intervals.icu OAuth Login Permissions

When you log into Intervals Companion, it connects to your Intervals.icu account using OAuth. During this process, Intervals.icu presents a permission screen where you grant the app access to your data. If Activities or Wellness Data update permissions were not checked, syncing will not work correctly.

The permissions screen should look like this, with Read and Update checked for Activities and Wellness Data:

Intervals.icu OAuth permissions screen showing Activities and Wellness Data with Read and Update checked

Make sure Activities and Wellness Data have both Read and Update checked

To fix missing permissions:

  1. Open the Intervals Companion app
  2. Go to Settings
  3. Tap Logout
  4. Log back in with your Intervals.icu credentials
  5. On the permissions screen, make sure activities and wellness Data both have read and update checked before tapping OK

2. iOS Health Permissions

Intervals Companion needs permission to read from and write to Apple Health. If these permissions were denied or only partially granted, syncing metrics and activities will be incomplete.

Health permissions are managed in iOS Settings, not inside the app. The easiest fix is to enable all permissions:

  1. Open the Settings app on your iPhone
  2. Go to Privacy & Security
  3. Tap Health
  4. Tap Intervals Companion
  5. Tap Turn On All at the top of the screen
iOS Health permissions screen for Intervals Companion showing Turn On All option

Tap "Turn On All" to grant Intervals Companion full Health access

Note: Even if the app previously requested permissions and you tapped "Allow", some categories may have been left off. Visiting this screen and tapping "Turn On All" ensures nothing is missing.

3. Intervals.icu API Key

Some features in Intervals Companion — including viewing other users activities and leaving comments on them — require a valid API key to be present in your Intervals.icu account. If you have never generated one, this step is required to use these features.

To create or view your API key:

  1. Go to intervals.icu/settings in a browser
  2. Scroll down to the Developer Settings section
  3. Click (view) under API Key
  4. If no key exists, click Generate to create one
  5. Go to the app settings, tap the Logout button and log back in again
Intervals.icu Developer Settings section showing Athlete ID and API Key with a (view) link

Developer Settings section — click (view) under to API Key

Intervals.icu API Key dialog showing GENERATE button

Click GENERATE if no key exists yet

Note: Once a key exists, Intervals Companion reads it automatically — you do not need to copy or enter it anywhere in the app. Simply having the key present in your account is sufficient.