Skip to main content
POST
/
v1
/
org
/
{org_id}
/
team_custom_credentials
/
{env}
/
{region}
curl --request POST \
  --url https://api.management.junction.com/v1/org/{org_id}/team_custom_credentials/{env}/{region} \
  --header 'Content-Type: application/json' \
  --header 'X-Vital-Org-Key: <api-key>' \
  --data '{
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "provider": "oura",
  "client_id": "<string>",
  "client_secret": "<string>",
  "details": {
    "fitbit": {
      "is_hr_enabled": true,
      "workout_verify_token": "<string>",
      "sleep_verify_token": "<string>",
      "body_verify_token": "<string>"
    }
  }
}'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "client_id": "<string>",
  "client_secret_hash": "<string>",
  "details": {
    "fitbit": {
      "workout_verify_token": "<string>",
      "sleep_verify_token": "<string>",
      "body_verify_token": "<string>",
      "is_hr_enabled": false,
      "foods_verify_token": "<string>"
    }
  },
  "app_url": "<string>",
  "redirect_url_override": "<string>"
}
Junction Management API is available for the Scale plan.
The base URL of this endpoint is https://api.management.junction.com/.The endpoint accepts only Management Key (X-Management-Key). Team API Key is not accepted.

​
OAuth Providers

Bring Your Own OAuth (BYOO) is available for the Grow and Scale plans. WHOOP BYOO is available for the Launch, Grow and Scale plans. See our WHOOP Guide for more information.
While most credentials are active immediately once set through this endpoint, some credentials may not. Check out the Bring Your Own OAuth documentation for more information. 
curl --request POST \
  --url https://api.management.junction.com/v1/org/{org_id}/team_custom_credentials/{env}/{region} \
  --header 'Content-Type: application/json' \
  --header 'X-Vital-Org-Key: <api-key>' \
  --data '{
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "provider": "oura",
  "client_id": "<string>",
  "client_secret": "<string>",
  "details": {
    "fitbit": {
      "is_hr_enabled": true,
      "workout_verify_token": "<string>",
      "sleep_verify_token": "<string>",
      "body_verify_token": "<string>"
    }
  }
}'

Authorizations

​
X-Management-Key
string
header
required

Path Parameters

​
org_id
string<uuid>
required
​
env
enum<string>
required
Available options:
production,
sandbox
​
region
enum<string>
required
Available options:
us,
eu

Body

application/json
​
team_id
string<uuid>
required
​
provider
required
Available options:
oura,
fitbit,
garmin,
whoop,
strava,
renpho,
peloton,
wahoo,
zwift,
freestyle_libre,
abbott_libreview,
tandem_source,
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,
samsung_health,
polar,
cronometer,
kardia,
whoop_v2,
ultrahuman,
my_fitness_pal_v2,
map_my_fitness,
runkeeper,
google_health
​
client_id
string | null
​
client_secret
string | null
​
details
FitbitTeamProviderDetails · object
​
redirect_url_override
string | null

Response

Successful Response

​
id
string<uuid>
required
​
source
required
Available options:
oura,
fitbit,
garmin,
whoop,
strava,
renpho,
peloton,
wahoo,
zwift,
freestyle_libre,
abbott_libreview,
tandem_source,
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,
samsung_health,
polar,
cronometer,
kardia,
whoop_v2,
ultrahuman,
my_fitness_pal_v2,
map_my_fitness,
runkeeper,
google_health
​
team_id
string<uuid>
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
client_id
string | null
​
client_secret_hash
string | null
​
details
FitbitTeamProviderDetails · object
​
app_url
string | null
​
redirect_url_override
string | null