FreestyleLibre Integration
With Terra's FreeStyle Libre integration, you can allow your users to share their blood glucose information with your app. By scanning their FreeStyle Libre Sensors (compatible with FreeStyle Libre 1, FreeStyle Libre 2, and FreeStyle Libre 3 systems) in their LibreLink app, users will share their Blood Glucose data with your app through the Terra API Integration. This will push raw glucose values, glucose trends, and glucose alarms to your app so you can closely track your users' glucose levels through an easy-to-use API
freestylelibre integration
STEP 1
What you need to integrate with FreestyleLibre
freestylelibre integration steps, step 1
Terra API Key
Once you sign up, we will provide you with an API key used to access our API
freestylelibre integration steps, step 2
Developer ID
We will provide you with a Developer ID, which allows Terra to identify users that belong to you, and associate API traffic to you.
freestylelibre integration steps, step 3
Webhook URL
You will need to set up a server (or use a testing environment like https:// webhook.site) that accepts POST requests from Terra
With the above set up, the only thing left to do is to allow your users to connect their Libre account to your app. This will allow you to receive their glucose data, and track their glucose levels in real time. To do that, you will create an authentication link through the Terra API, which your users will be redirected to. Once on that page, users will be prompted to log in using their FreeStyle Libre credentials. Those are the same credentials used in the Libre 3, LibreLink, Libre 2, or LibreView app
The video below shows how to connect users' FreeStyle LibreView account to your app using Terra's Freestyle Libre API integration.
STEP 2
Data Format

All data is sent to your webhook in JSON format in the form of 5 different types of payloads: Body. Depending on your needs, you may select a subset of the aforementioned, and request less data from your users.

Examples of data payloads can be found here. If you would only like to receive specific fields out of the ones available, you may also select only the ones relevant to your needs and omit the rest. The following is an example of the data payload you may expect from an activity coming from Terra.

STEP 3
Receiving data for your FreestyleLibre integration - WEBHOOKS

Whenever data become available from a FreestyleLibre device, they will be streamed to you, via our webhooks. When setting up your Terra account, you will be prompted to provide a callback URL, to which Terra may send PUSH data using POST requests.

Your FreestyleLibre integration with Terra supports instant delivery of data without needing to periodically request it yourself. FreestyleLibre notifies Terra whenever new data is available, following which we POST the normalized data to your webhook.

FreestyleLibre
receiving data from freestylelibre integration via webhooks to your app or website
STEP 4
Historical data from HTTP requests

You may also use HTTP requests with your FreestyleLibre integration in case you wish to request historical data or data over extended periods of time.

Most HTTP endpoints can take additional parameters start_date and end_date which allow you to request data over a specific period for the given user.

The type of data that FreestyleLibre has
You can access the following data through your FreestyleLibre integration with the Terra API
freestylelibre integration data
Body .JSON