Quick links:
The Garmin Health connector enables the synchronization of Garmin data to Teamworks AMS. Garmin Health collects a diversity of health, fitness and wellbeing data based on metrics such as sleep, heart rate, stress and exercise. Integrating your AMS site with Garmin Health provides an opportunity for deep insights into these metrics, and helps bring all of your data together to make holistic decisions related to people’s health, performance and risk of injury.
Setting up your AMS site to integrate with Garmin Health
What we need from you
Not much! Once you’ve confirmed you’d like to go ahead with the integration, we will set it up for you.
What we will do
- Universally unique identifications (UUIDs) must be enabled for your AMS site so that the Garmin Health connector can identify which accounts people belong to. This is a setting in your site application details.
- We will add the relevant event forms to your site. These forms will connect with and store all data from Garmin Health. Depending on how Garmin is used by your organization, some or all of these forms will receive data from Garmin. You can work with your Product Success Manager to ensure the appropriate roles have access to view this information, as well as any dashboards set up to visualize the data.
- Garmin Daily Summary
- Garmin Activity Summary
- Garmin Sleep Summary
- Garmin Body Composition Summary
- Garmin Move IQ Summary
- Garmin Stress Summary
- Garmin Pulse OX Summary
- Garmin User Metrics Summary
- There are two profile forms associated with this integration.
- The Garmin Health OAuth Portal profile is used by the Garmin Connect account holders to authorize the data connection using AMS through a web browser. If they are authorizing the connection via the AMS mobile app, this form is not required.
- The Garmin Athlete Token Info profile also communicates with the Garmin Health connector but does not need any interaction from you or your organization. All Garmin Connect account holders need access to this form, regardless of whether they use the web or mobile app to authorize the connection.
Please speak to your Product Success Manager before adding any new fields to the above event and profile forms as it may have unintended consequences.
Once connected, data will synchronize with AMS as soon as it’s saved to Garmin Health.
How are people’s accounts mapped between Garmin Health and AMS?
Each person has to authorize AMS to access their Garmin Health data via AMS in a web browser or the AMS mobile app (available from version 1.6.0). This process must only be completed after the connector setup is fully completed.
Mobile app
Web
- Log into the AMS mobile app using your account credentials. Ensure the latest version of the app is loaded.
- Follow the prompts to set up Connected apps and select Garmin Connect. If this step is skipped, you can do it later in by navigating to the app Settings > Connected apps > Garmin Connect.
- Select Set up. This will redirect you to a separate web page within the app where you can confirm your Garmin Connect account credentials.
Once this process is completed, your AMS account will be authorized to connect to your Garmin Health data. No further mapping is required.
To revoke access to the Garmin Connect account, go to the app Settings > Connected apps > Garmin Connect and use the toggle to disable the connection.
- Log into AMS using a web browser (e.g. Google Chrome or Mozilla Firefox) using your account credentials (this process must be completed with the person logged into their own account, not via a coach’s account).
- Go to the Profiles page.
- Select the Garmin Health OAuth Portal profile form.
- Click the Authorisation link button and follow the prompts to enter your Garmin Health account details.
Once this process is completed, your AMS account will be authorized to connect to your Garmin Health data. No further mapping is required.
Creating heart rate zones from Garmin Health connector data
You can optionally calculate heart rate zones (based on the percent of an individual’s max heart rate) for an activity within the Garmin Activity Summary form. To achieve this, we will add:
- A database form called Garmin HR Zones, which you can use to customize the percentage limits for each zone. You can create as many zones as required. Note that the Zone label must start with a numerical value.
- A profile form called Max HR where you can indicate each person’s maximum heart rate. This is used by the connector to calculate the specific heart rate zones for each individual.
Once you’ve added your heart rate zone labels and percentage limits to the database, anyone with a maximum heart rate specified in the Max HR profile form will have their heart rate zones included within the Garmin Activity Summary form.
Troubleshooting this integration
If you're experiencing any issues with this integration, please contact Teamworks support.