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 your Terra Dashboard on the Connections page, and set up data &
If you are just starting off building your product and want to test how Terra works, use https://webhook.site to set up a testing webhook going forward.
For further information about each destination, please see
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 Connect a User), select permissions displayed for each
In order to then start receiving data, you'll learn what kind of data messages you can expect, before receiving real world data by connecting a user. 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.
Before going LIVE (release), you will ALSO need to apply for permissions to access the Health Connect API with Google. Use this application form.
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.
Those integrations are any of the ones with credentials marked as N/A in the table above
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.
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 table above
Log in to https://strava.com/settings/api
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
Request an API key from https://virtuagym.com/public-api
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
This can be achieved by following the Registration & Verification guide
Through the Huawei ID Registration process, you will be asked to verify your identity.
If you own a business, please follow the guide for DUNS number verification or the guide using a Business License
If you are an individual developer, follow this guide 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 here for a step-by-step explanation on how to achieve that
📘 Important parameters
Redirect URL
App access URL
Callback address
Please follow the guide Health Kit access here 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 these steps:
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.
