Generate a link token
Endpoint to generate a user link token, to be used throughout the vital link process. The vital link token is a one time use token, that expires after 10 minutes. If you would like vital-link widget to launch with a specific provider, pass in a provider in the body. If you would like to redirect to a custom url after successful or error connection, pass in your own custom redirect_url parameter.
Authorizations
Vital Team API Key
Body
User id returned by vital create user request. This id should be stored in your database against the user and used for all interactions with the vital api.
ℹ️ This enum is non-exhaustive.
oura
, fitbit
, garmin
, whoop
, strava
, renpho
, peloton
, wahoo
, zwift
, freestyle_libre
, abbott_libreview
, freestyle_libre_ble
, eight_sleep
, withings
, apple_health_kit
, manual
, ihealth
, google_fit
, beurer_api
, beurer_ble
, omron
, omron_ble
, onetouch_ble
, accuchek_ble
, contour_ble
, dexcom
, dexcom_v3
, hammerhead
, my_fitness_pal
, health_connect
, polar
, cronometer
, kardia
, whoop_v2
, ultrahuman
, my_fitness_pal_v2
, map_my_fitness
An allowlist of providers dictating what Vital Link Widget should show to the end user. If unspecified, all linkable providers are shown.
This has no effect on programmatic Vital Link API usage.
ℹ️ This enum is non-exhaustive.
oura
, fitbit
, garmin
, whoop
, strava
, renpho
, peloton
, wahoo
, zwift
, freestyle_libre
, abbott_libreview
, freestyle_libre_ble
, eight_sleep
, withings
, apple_health_kit
, manual
, ihealth
, google_fit
, beurer_api
, beurer_ble
, omron
, omron_ble
, onetouch_ble
, accuchek_ble
, contour_ble
, dexcom
, dexcom_v3
, hammerhead
, my_fitness_pal
, health_connect
, polar
, cronometer
, kardia
, whoop_v2
, ultrahuman
, my_fitness_pal_v2
, map_my_fitness
By default, Vital Link Widget input forms for password and email providers have in-built error handling.
Specifying on_error=redirect
disables this Vital Link Widget UI behaviour — it would
instead redirect to your redirect_url
, with Link Error parameters injected.
This has no effect on OAuth providers — they always redirect to your redirect_url
. This also has
no effect on programmatic Vital Link API usage.
"redirect"
By default, Vital Link Widget closes the window or tab when the user taps the Close button.
Specifying on_close=redirect
would change the Close button behaviour to redirect to your redirect_url
with the user_cancelled
error specified.
This has no effect on programmatic Vital Link API usage.
"redirect"
Response
A short-lived Vital Link token for your Custom Link Widget to communicate with the Vital API.
The web browser link to launch the default Vital Link experience. If you requested the token for one specific provider, the link would redirect directly to the provider authentication flow. Otherwise, the user would be presented with a list of providers based on your team and token configurations.