There are multiple methods for connecting participant devices to your Fitabase project. This tutorial will show you how to use the manual connection option for connecting devices. Manual connection works best when you control the Fitbit accounts that will be associated with each of your participant's devices. 

To manually connect a participant first navigate to the Connected Devices page by using the dashboard menu link. 


The connected users page will display all currently connected and invited participants. To manually connect your participant, click the Manually Connect Device button. 


The Manually Connect Device page will prompt you to enter in information for the participant you will be connecting. 

You will need to enter a participant identifier. In the Syncing section, should also specify the observation window through which you would like data to be actively pulled into Fitabase from that particular profile. This step will ensure that data capture from your participants will only take place during the date range that you have designated. Fitabase will continue to pull in new data from all active profiles until an end date is entered. It is strongly suggested that you enter an observation window. This date range can later be adjusted. If needed, you can set multiple timeframes for intermittent data collection. 

Click the Save changes button to save this participant and associated data collection timeframe.



Participant IDs can be any combination of alphanumeric characters.

Fitabase will create your participant (user) ID and ask that you connect a Fitbit to that ID.

Click on Connect a Fitbit to this user to start the connection and authorization process.  


Fitabase will send you to in order to login and authorize Fitabase to access (read) data. 

First, you will be asked to sign in with the Fitbit account information (email and password) that you created. 


Once you sign in you will be sent to the authorization screen and be asked to allow Fitabase to access the data associated with the Fitbit account. 

Leave all boxes checked and then click Allow. 



You must leave all boxes checked before clicking allow in order for Fitabase to properly access data.

Congrats! You've just connected your first Fitbit account to your Fitabase project.

Once you've connected a Fitbit account it will show up on your project dashboard. If a device has been connected the device name will be shown. You may also see a message "No Device Sync Yet." This message will be shown until the associated Fitbit device syncs with Fitbit and data is made available. 



You can continue to connect additional devices using the steps above for all Fitbit accounts you control. 

If you do not control the Fitbit accounts, or you are recruiting participants that already have their own Fitbits and Fitbit accounts, you can use our Invitation Link method to connect those accounts.