> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# RunKeeper Connector

## Intro

RunKeeper is a GPS fitness-tracking app for iOS and Android. It allows users to track fitness activities using GPS and to see detailed statistics around their pace, distance, and time. You can use Domo's RunKeeper connector to compile reports about physical activity, health, and nutrition. To learn more about the RunKeeper API, visit their page ([http://runkeeper.com/developer/healthgraph/](http://runkeeper.com/developer/healthgraph/)).

The RunKeeper connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window.

You connect to your RunKeeper account in the Data Center. This topic discusses the fields and menus that are specific to the RunKeeper connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

<table class="mt-responsive-table" data-aura-rendered-by="33:195;a"><tbody><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Use Cases </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><ul><li><p> Monitoring fitness over time and exercise trends </p></li><li><p> Competition between friends and coworkers about running data </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Metrics </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><ul><li><p> Distance traveled </p></li><li><p> Time of activity </p></li><li><p> Average pace </p></li><li><p> Location of activity </p></li><li><p> Friends' activities </p></li><li><p> Rankings </p></li><li><p> Type of activity </p></li><li><p> Sleep </p></li><li><p> Nutrition data </p></li><li><p> Weight data </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Company Roles </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><ul><li><p> HR roles </p></li><li><p> Anyone who wants to keep track of health and fitness data </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Average Implementation Time </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 5 minutes </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Ease of Use (on a 1-to-10 scale with 1 being easiest) </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 2 </p></td></tr></tbody></table>

## Best Practices

* Authenticate when you create the DataSet.
* Use the [RunKeeper QuickStart App](/s/article/360043438593 "RunKeeper QuickStart App") to quickly generate relevant cards and metrics from different connector reports.

## Prerequisites

To connect to your RunKeeper account and create a DataSet, you must have the following:

* The email address you use to log into RunKeeper
* The password you use to log into RunKeeper

You can also connect to your RunKeeper account by signing into Facebook or Google+ and indicating that you want to create a connection to RunKeeper.

## Connecting to Your RunKeeper Account

This section enumerates the options in the **Credentials** and **Details** panes in the RunKeeper Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

The Domo RunKeeper connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click **Connect** (or select **Add Account** if you have existing RunKeeper accounts in Domo) to open the RunKeeper OAuth screen where you can choose whether to connect to RunKeeper by entering your RunKeeper, Facebook, or Google+ credentials. Once you have connected to RunKeeper and authorized Domo to connect to RunKeeper, you can use the same account any time you go to create a new RunKeeper DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

<Note>
  **Note:** If you are already logged into RunKeeper when you connect in Domo, you are authenticated automatically when you click Add account. If you want to connect to an account that is different from the one you are logged into, you must first log out of RunKeeper.
</Note>

### Details Pane

This pane contains a primary menu, **Report**, along with two fields for entering timeframe data.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select a RunKeeper report. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Background Activities </p></td><td colspan="1" rowspan="1"><p> Returns information about physical activity that occurs normally throughout the day, such as calories burned and steps taken. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Diabetes Measurements </p></td><td colspan="1" rowspan="1"><p> Returns metrics about the user's blood glucose and hormone levels. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Fitness Activities </p></td><td colspan="1" rowspan="1"><p> Returns activities that appear in the user's fitness feed on the RunKeeper website. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Friends </p></td><td colspan="1" rowspan="1"><p> Returns the user's list of friends, with user ID, full name, profile URL, and status (pending or member). </p></td></tr><tr><td colspan="1" rowspan="1"><p> General Body Measurements </p></td><td colspan="1" rowspan="1"><p> Returns body measurements such as blood pressure, cholesterol, vitamin intake, white cell count, etc. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Nutrition </p></td><td colspan="1" rowspan="1"><p> Returns statistics about the user's diet. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Personal Records </p></td><td colspan="1" rowspan="1"><p> Returns a list of the user's personal best records. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Profile </p></td><td colspan="1" rowspan="1"><p> Returns the user's profile information, such as identity, geographical location, and fitness goals. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Settings </p></td><td colspan="1" rowspan="1"><p> Returns the user's sharing and display preferences. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sleep </p></td><td colspan="1" rowspan="1"><p> Returns sleep statistics for the user, such as the length of time spent in various sleep stages and the number of times awoken during the night. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Strength Training Activities </p></td><td colspan="1" rowspan="1"><p> Returns information about the user's strength training activities. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Weight </p></td><td colspan="1" rowspan="1"><p> Returns statistics about the user's weight and body mass in kilograms. </p></td></tr></tbody></table><p /></td></tr><tr><td colspan="1" rowspan="1"><p> Start Days </p></td><td colspan="1" rowspan="1"><p> Enter the number of the farthest day back that should be represented in the report. Combine with <b> End Days </b> to create a range of represented days. For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Start Days </b> and <span class="mt-font-courier-new"> 5 </span> for <b> End Days </b>, the report would contain data for 10 days ago up until 5 days ago. Enter <span class="mt-font-courier-new"> 0 </span> for today. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Days </p></td><td colspan="1" rowspan="1"><p> Enter the number of the most recent day back that should be represented in the report. Combine with <b> Start Days </b> to create a range of represented days. For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Start Days </b> and <span class="mt-font-courier-new"> 5 </span> for <b> End Days </b>, the report would contain data for 10 days ago up until 5 days ago. Enter <span class="mt-font-courier-new"> 0 </span> for today. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## Troubleshooting

Ensure you are using the correct credentials.
