> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/unified-api/dedicated-data-source-api-keys.md).

# Dedicated source API keys

Set up your own developer credentials for Strava, Virtuagym, Huawei and Samsung Health instead of using Terra's managed keys.

Terra manages the API keys of data sources, so you can connect users without applying for each key yourself. This page covers how to set up your own access keys for the sources that support them.

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

1. **Required by the provider:** the provider requires in their 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 [integrations table](https://docs.tryterra.co/unified-api/supported-integrations#integrations-list), marked as `Managed`. The table also lists each provider's developer dashboard.

## Strava

1. Log in to <https://strava.com/settings/api> and create an application. Save its client ID and client secret.
2. In your Terra dashboard, open **Connections**, choose **Strava** and follow the setup. It walks you through your custom domain and then shows the Authorization Callback Domain to enter in your Strava application.
3. Enter the client ID and client secret in the dashboard and save. Terra registers the Strava webhook for you.

## Virtuagym

1. Generate an API key from your Virtuagym Professional account, under **System Settings → Business Info → Advanced**. If the option isn't visible, contact Virtuagym support.
2. In your Terra dashboard, add Virtuagym to your connections under API > Connections > Add more.
3. After adding Virtuagym, go to the Virtuagym options.
4. Fill your portal name in the client ID, and your API key in the client secret.

## Huawei

### Create a Huawei ID

Follow the [Registration & Verification guide](https://developer.huawei.com/consumer/en/doc/start/registration-and-verification-0000001053628148).

{% hint style="info" %}
**Identity verification**

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

* If you own a business, follow the guide for [DUNS number verification](https://developer.huawei.com/consumer/en/doc/start/atpopb-0000001062836624) or the guide [using a Business License](https://developer.huawei.com/consumer/en/doc/start/mracoei-0000001062678404).
* If you are an individual developer, follow [this guide](https://developer.huawei.com/consumer/en/doc/start/ibca-0000001062388135) using your personal documents.
  {% endhint %}

### Apply for the HUAWEI ID Service

This is separate from the Huawei ID registration: the *service* is what lets you access the Huawei APIs. Follow the guide [here](https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/apply-id-0000001050069756) for a step-by-step explanation.

Use these parameters:

<table><thead><tr><th width="181.591796875">Name</th><th width="490.4951171875">Value</th></tr></thead><tbody><tr><td><strong>Redirect URL</strong></td><td><a href="https://api.tryterra.co/v2/auth/huawei/oauth2">https://api.tryterra.co/v2/auth/huawei/oauth2</a></td></tr><tr><td><strong>App access URL</strong></td><td><a href="https://api.tryterra.co/">https://api.tryterra.co/</a></td></tr><tr><td><strong>Callback address</strong></td><td><a href="https://api.tryterra.co/v2/auth/huawei/oauth2">https://api.tryterra.co/v2/auth/huawei/oauth2</a></td></tr></tbody></table>

### Apply for Huawei Health Kit access

1. Follow the [Health Kit access guide](https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/apply-kitservice-0000001050071707) for an in-depth explanation of how to gain access to users' health data through Huawei Health Kit.
2. Register for notifications (webhooks) by following [these steps](https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/subscription-0000001078496860#section38652513104):

![](https://files.readme.io/c6f3b5d-image.png)

## Samsung Health

The Android SDK can read Samsung Health's own store directly, through Samsung's Health Data SDK, instead of through Health Connect. Direct access reads every Samsung Health workout, including the ones Samsung Health does not copy into Health Connect.

Samsung approves each app separately, so Terra's access does not cover your app. Apply through the [Samsung Health partnership portal](https://developer.samsung.com/SHealth/business-partner/m48wvqi1mt9w2w4c) with your app's package name and the SHA-256 fingerprint of its signing certificate. Until Samsung approves it, you can read Samsung Health's data through Health Connect.

For the add-on, Samsung's SDK and the code, see [Samsung Health](https://docs.tryterra.co/mobile-sdks/samsung-health.md).

## Next steps

* [Per-user OAuth apps](https://docs.tryterra.co/unified-api/per-user-oauth-apps.md): let each end user bring their own provider app.
* [Destinations](https://docs.tryterra.co/destinations/setting-up-data-destinations.md): choose where Terra sends data.
* [User authentication](https://docs.tryterra.co/unified-api/authentication-flow.md): open the widget from your app.
