The Garmin Health connector enables the synchronization of Garmin data to Smartabase. Garmin Health collects a diversity of health, fitness and wellbeing data based on metrics such as sleep, heart rate, stress and exercise. Integrating your Smartabase 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 Smartabase 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, one of us at Smartabase will set it up for you.
What Smartabase will do
- Universally unique identifications (UUIDs) must be enabled for your Smartabase site so that the Garmin Health connector can identify which accounts people belong to. This is a setting in your site Application details, which can only be changed by your Smartabase consultant.
- Your Smartabase consultant 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 Smartabase consultant 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. Note that these profile forms need to be enabled for the Athlete app in the builder interface.
- The Garmin Health OAuth Portal profile is used by the Garmin Connect account holders to authorize the data connection to Smartabase using Smartabase Online (i.e. the web browser). If they are authorizing the connection via the Smartabase Athlete 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 Smartabase Online or the Athlete app to authorize the connection.
Please speak to your Smartabase consultant before adding any new fields to the above event and profile forms as it may have unintended consequences.
Once connected, data will synchronize with Smartabase as soon as it’s saved to Garmin Health.
How are people’s accounts mapped between Garmin Health and Smartabase?
Each person has to authorize Smartabase to access their Garmin Health data via Smartabase Online (i.e. web browser) or the Smartabase Athlete app (available from version 1.31.1). Note that this process must only be completed after the connector setup is fully completed.
Steps for people to authorize Garmin Health integration via Smartabase Online (web browser)
- Log into Smartabase Online using a web browser (e.g. using Google Chrome or Mozilla Firefox) using their own 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, the person’s Smartabase account will be authorized to connect to their Garmin Health data. No further mapping is required.
Steps for people to authorize Garmin Health integration via the Smartabase Athlete app
- Log into the Smartabase Athlete app using their own 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, they can do it after logging in by navigating to the app Settings > Connected apps > Garmin Connect.
- Select Set up. This will redirect the person to a separate web page within the app where they can confirm their Garmin Connect account credentials.
Once this process is completed, the person’s Smartabase account will be authorized to connect to their 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.
Creating heart rate zones from Garmin Health connector data
You can optionally calculate heart rate zones (based on percent of an individual’s max heart rate) for an activity within the Garmin Activity Summary form. To achieve this, your Smartabase consultant 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.