Link Flow

Understand the end-to-end Junction Link flow for connecting wearable devices, from API key setup through Link Token generation.

Junction Link API covers only cloud-based providers.

Your mobile app has to manage connections with SDK-based providers — such as Apple HealthKit and Android Health Connect — through the Junction Mobile Health SDK, separately from Junction Link.

The Junction Link flow starts when a user wants to connect a wearable device with Junction. An overview of the process can be found below.

1. Prerequisites

   Make sure that:

   1. You have your Junction Team API Key from the dashboard ready to use.

   2. You have created a Junction User that corresponds to a user in your domain. See here for an example.

2. Generate a Link Token

   Call the Generate a Link Token endpoint with the target User ID using your Junction Team API Key.

3. Initiate the Link Flow

   The API response provides a short-lived Link Token (link_token), as well as a Web URL (link_web_url).

   You can use the Web URL to launch the Junction Link Widget directly. Alternatively, you can use the Link Token in concert with the Junction Link API to build your custom Link Widget experience.