Fitbit Health Metrics added

As of Monday September 26, 2022, the following Inform API health metrics will be populated when users grant access to the appropriate scopes and data is provided by Fitbit. This data will appear in summaries records for users when captured by their Fitbit smartwatch.

Inform MetricDescriptionResourceData TypeUnitsRequired Fitbit Scope
avg_spo2The average blood oxygen saturation of the individual. Measured as defined by the source.summariesfloatpercentoxygen saturation (SpO2)
max_spo2The maximum blood oxygen saturation of the individual. Measured as defined by the source.summariesfloatpercentoxygen saturation (SpO2)
min_spo2The minimum blood oxygen saturation of the individual. Measured as defined by the source.summariesfloatpercentoxygen saturation (SpO2)
respiratory_rateThe average number of breaths per minute of the individual. Measured as defined by the source.summariesfloatb/m (breaths per minute)breathing rate
heart_rate_variabilityThe heart rate variability of the individual as determined by the source.summariesfloatmsheart rate
(this is a currently supported scope so if users have already granted access to this scope, you will see this data come in automatically without the user needing to reconnect)

With this change, users will automatically be prompted to grant access to the new scopes when they initiate the Fitbit OAuth connection from the Inform marketplace.

958

Updated Fitbit scope selection screen

Any users who are already connected to Fitbit will not be notified of these new permissions. Users who are already connected to Fitbit must disconnect and reconnect to Fitbit if they want to share this new data with you. During Fitbit OAuth, users must grant access to the scopes listed in the table above before these new data points will be available to you in the Inform API.

An example excerpt of a summaries record is shown below and includes these new metrics:

...
"metrics": [
								{
                    "type": "heart_rate_variability",
                    "value": 37.975,
                    "unit": "ms",
                    "origin": "device"
                },
                {
                    "type": "avg_spo2",
                    "value": 96.7,
                    "unit": "percent",
                    "origin": "device"
                },
                {
                    "type": "min_spo2",
                    "value": 95.9,
                    "unit": "percent",
                    "origin": "device"
                },
                {
                    "type": "max_spo2",
                    "value": 97.5,
                    "unit": "percent",
                    "origin": "device"
                },
                {
                    "type": "respiratory_rate",
                    "value": 18.0,
                    "unit": "b/m",
                    "origin": "device"
                },
.....
]