Terra Docs
Dashboard
  • Docs
  • API Reference
  • Changelog
  • Getting Started
    • What is Terra API?
    • Account setup and API keys
    • Core concepts
  • Health & Fitness API
    • Overview
    • Quickstart
    • Integration setup
      • Understanding sources and destinations
      • Setting up data sources
      • Setting up data destinations
        • Webhooks
        • SQL database (Postgres, MySQL)
        • Supabase
        • Cloud storage (S3, GCP)
        • Queuing services (SQS, Kafka)
      • Customising data types
      • Dedicated data source API keys
      • Understanding Terra environments
    • User authentication
      • Authentication flow
      • Implementation (Terra widget)
      • Implementation (Custom UI)
      • Handling authentication events
      • Customising authentication redirects
    • Managing user health data
      • Receiving health data updates (events)
      • Requesting historical health data (REST API requests)
      • Writing data
    • Mobile-only sources
      • iOS (Swift)
      • Android (Kotlin)
      • React Native
      • Flutter
    • Troubleshooting
    • Pricing
  • User Engagement
    • Health Scores
  • Streaming API
    • Overview
    • Wearable -> Your app
      • iOS (Swift)
      • Android
    • Your app -> Terra
      • iOS (Swift)
      • Android
    • Terra -> Your backend
  • Teams API
  • Biomarkers API - Upcoming
Powered by GitBook
On this page
  • Overview
  • How to Setup Dedicated Access Keys?
  • Strava
  • Virtuagym
  • Huawei
  • FreestyleLibre
  • Samsung Health - Direct Connection Route

Was this helpful?

  1. Health & Fitness API
  2. Integration setup

Dedicated data source API keys

PreviousCustomising data typesNextUnderstanding Terra environments

Last updated 19 days ago

Was this helpful?

Overview

Terra manages API Keys of data sources, meaning you can connect users without having to apply for each API Key.

For some Data Sources, you may choose to have your own access keys for different reasons:

  1. Required by the provider: the provider requires it in there terms that you use dedicated access keys.

  2. Preferred by you: you simply wish to avoid rate limits and separate your environment from the managed Terra keys.

You can find the list of providers that support this in the marked as Managed. We also included their appropriate developer dashboard in the table.


How to Setup Dedicated Access Keys?

Strava

  1. Log in to

  2. Create an application

  3. Set the Authorization callback domain to api.tryterra.co, and save the client ID and client secret obtained

  4. In your Terra dashboard, add Strava to your connections under API > Connections > Add more

  5. Fill in the obtained client_id and client secret on that connection's settings


Virtuagym

  • 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


Huawei

📘 Identity verification

Through the Huawei ID Registration process, you will be asked to verify your identity.

  1. Apply for the HUAWEI ID Service

  • Important parameters

Name
Value

Redirect URL

App access URL

Callback address

  1. Apply for Huawei Health Kit access


FreestyleLibre

In Germany 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 after having created a professional account, you then would need to submit a support ticket for activation and we will be able to proceed as per the normal procedure.


Samsung Health - Direct Connection Route

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.

Request an API key from

Create a Huawei ID: 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 :

integrations table
https://strava.com/settings/api
https://virtuagym.com/public-api
Registration & Verification guide
DUNS number verification
using a Business License
this guide
here
here
these steps
https://api.tryterra.co/v2/auth/huawei/oauth2
https://api.tryterra.co/
https://api.tryterra.co/v2/hooks/huawei/healthkit/notifications