Skip to end of metadata
Go to start of metadata

Introduction

The Fitbit API can be used to read and write data for a user's activity, food logging and personal data. In order to fully integrate, you will need to log in or sign up with the Fitbit platform, register for an API key, and use that key to drive interaction on behalf of an authenticated user.

The Fitbit API, currently in BETA and under construction, allows 3rd-party apps to get and modify a Fitbit user's data. For most API calls, apps must first be authenticated using OAuth Authentication as described in The OAuth 1.0 Protocol (draft-hammer-oauth-10). Apps can also subscribe to any changes in a user's data. This allows apps to be updated in near real-time.

For instance, Website A wants to integrate with Fitbit.com so that Website A's users can integrate their Fitbit data into Website A.

There is a user Joe, who has an account on both Website A and Fitbit.com. First, Joe allows Website A to access and modify his Fitbit data. Once this authentication occurs, Website A can freely make HTTP calls to get and to modify Joe's data. Website A can also subscribe to any changes in Joe's data. For instance, when Joe updates his daily step count, Fitbit.com automatically notifies Website A of this change via an HTTP callback.

Quick Start Guide

  1. Register a new application and get an API consumer key and secret.
    • The API consumer key and secret will give your application access to Fitbit.
    • You will register and manage your application as a Fitbit user.
  2. Use one the available client API libraries that encapsulate the low-level HTTP calls

Learn how these clients work by clicking the URLs above and/or reading Anatomy of a Fitbit Client Application.

If you are using a language not supported above or would like to see the details of the underlying HTTP protocol, please see the following:

  • OAuth Authentication API shows you how to authenticate your application to access a user's data
  • Resource Access API explains each of the API calls to get or retrieve a user's data
  • Subscriptions API explains how to subscribe to changes in a user's data and how to implement a callback that handles update notifications

For help, join the developer forum to interact with the Fitbit Developer Network community.

  • No labels
Page: API-Accept-Invite Page: API-Add-Favorite-Activity Page: API-Add-Favorite-Food Page: API-Browse-Activities Page: API-Config-Friends-Leaderboard Page: API-Create-Food Page: API-Create-Invite Page: API-Delete-Activity-Log Page: API-Delete-Blood-Pressure-Log Page: API-Delete-Body-Fat-Log Page: API-Delete-Body-Weight-Log Page: API-Delete-Favorite-Activity Page: API-Delete-Favorite-Food Page: API-Delete-Food-Log Page: API-Delete-Heart-Rate-Log Page: API-Delete-Sleep-Log Page: API-Delete-Water-Log Page: API-Devices-Add-Alarm Page: API-Devices-Delete-Alarm Page: API-Devices-Get-Alarms Page: API-Devices-Update-Alarm Page: API-Distance-Unit Page: API-Get-Activities Page: API-Get-Activity-Daily-Goals Page: API-Get-Activity-Stats Page: API-Get-Activity-Type Page: API-Get-Activity-Weekly-Goals Page: API-Get-Badges Page: API-Get-Blood-Pressure Page: API-Get-Body-Fat Page: API-Get-Body-Fat-Goal Page: API-Get-Body-Measurements Page: API-Get-Body-Weight Page: API-Get-Body-Weight-Goal Page: API-Get-Device Page: API-Get-Devices Page: API-Get-Favorite-Activities Page: API-Get-Favorite-Foods Page: API-Get-Food Page: API-Get-Food-Goals Page: API-Get-Food-Logs Page: API-Get-Food-Units Page: API-Get-Frequent-Activities Page: API-Get-Frequent-Foods Page: API-Get-Friends Page: API-Get-Friends-Leaderboard Page: API-Get-Glucose Page: API-Get-Heart-Rate Page: API-Get-Invites Page: API-Get-Meals Page: API-Get-Recent-Activities Page: API-Get-Recent-Foods Page: API-Get-Sleep Page: API-Get-Time-Series Page: API-Get-User-Info Page: API-Get-Water Page: API-Get-Water-Goal Page: API-Log-Activity Page: API-Log-Blood-Pressure Page: API-Log-Body-Fat Page: API-Log-Body-Measurements Page: API-Log-Body-Weight Page: API-Log-Food Page: API-Log-Glucose Page: API-Log-Heart-Rate Page: API-Log-Sleep Page: API-Log-Water Page: API-Search-Foods Page: API-Update-Activity-Daily-Goals Page: API-Update-Activity-Weekly-Goals Page: API-Update-Fat-Goal Page: API-Update-Food-Goals Page: API-Update-User-Info Page: API-Update-Water-Goal Page: API-Update-Weight-Goal