Set up your Integrations
Last updated
Was this helpful?
Last updated
Was this helpful?
In this guide, you'll learn how to enable & disable in one click, and connect Terra into your of choice
As a first step, head to on , and set up data &
Whenever you connect a through Terra, you may not want access to all data in their account. In order to customize what data you request from the user (see ), select permissions displayed for each
In order to then start receiving data, you'll learn what kind of you can expect, before receiving real world data by . Continue by learning about the different supported integrations, and any special processes required by any of them for setup
Health Connect-based integrations:
Integrations requiring dedicated credentials:
Currently the integrations mentioned above go through the newly developed Health Connect platform, which is an on-device storage system developed by Google. This platform however is still in its infancy, and comes with a number of issues.
We have seen numerous cases of apps not being able to sync into Health Connect due to bugs in the Health Connect platform itself. This could be, for example, Samsung Health not being able to send steps into HC.
We've also seen cases where HC data simply could not be accessed, for no apparent reason, leading to limited or no syncing of data possible.
In the form, you will need to specify which data types you intend to read from Health Connect.
As privileged partners of Samsung thanks to their investment in Terra, we have been granted access to their SDK for accessing Samsung Health directly without Health Connect.
This route is much preferred to the Health Connect route due to the reasons discussed above. For access to this route, please get in touch with us through our support channels.
Some of the integrations provided are developed on agreements subject to be updated by the integration providers. Their APIs can be modified without notifying Terra or 3rd parties, which could cause disruption in the service beyond our control.
For some providers such, you are may choose to have your own application keys either because the provider requires it in there terms, or to simply avoid rate limits and separate your environment from the managed Terra keys.
Create an application
Set the Authorization callback domain to api.tryterra.co, and save the client ID and client secret obtained
In your Terra dashboard, add Strava to your connections under API > Connections > Add more
Fill in the obtained client_id and client secret on that connection's settings
In you Terra dashboard, add Virtuagym to your connections under API > Connections > Add more
After adding Virtuagym, go the Virtuagym options
Fill your portal name in the client id, and your API Key in the client secret
Through the Huawei ID Registration process, you will be asked to verify your identity.
📘 Important parameters
Redirect URL
App access URL
Callback address
In Germany, Austria and France, it is necessary to have a doctor's license to be able to access Freestylelibre of users residing in said regions. This would mean having a registered practice. Once you have a practice id for a practice on the Libreview web app, you then would need to let us know the details and we will be able to proceed as per the normal procedure.
Before going LIVE (release), you will ALSO need to apply for permissions to access the Health Connect API with Google's . Additional information can be found .
Those integrations are any of the ones with credentials marked as N/A in the
The list of provider enums you may choose to create your own keys for & their appropriate developer dashboard is the ones with Managed credentials in the
Log in to
Request an API key from
This can be achieved by following the
If you own a business, please follow the guide for or the guide
If you are an individual developer, follow using your personal documents
This is separate from the Huawei ID registration - the service is what will allow you to then access various Huawei APIs). Follow the guide for a step-by-step explanation on how to achieve that
Please follow the guide Health Kit access for an in-depth explanation of how to gain access to users' health data through Huawei Health Kit
Make sure to register for notifications (webhooks) by following :
