Skip to main content
POST
/
v2
/
link
/
provider
/
email
/
{provider}
curl --request POST \
     --url {{BASE_URL}}/v2/link/provider/email/{provider} \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-vital-link-token: <VITAL-LINK-TOKEN>' \
     --data '
{
     "email": "test@email.com",
     "region": "us"
}
'
import { JunctionClient, JunctionEnvironment } from "@junction-api/sdk";

const client = new JunctionClient({
    apiKey: "YOUR_API_KEY",
    environment: JunctionEnvironment.Sandbox,
});

const tokenResponse = await client.link.token({ userId: "<user_id>" });

const data = await client.link.connectEmailAuthProvider({
    provider: "freestyle_libre",
    email: "<email>",
    vitalLinkToken: tokenResponse.linkToken,
});
from junction import Junction
from junction.environment import JunctionEnvironment

client = Junction(
    api_key="YOUR_API_KEY",
    environment=JunctionEnvironment.SANDBOX,
)

token_response = client.link.token(user_id="<user_id>")

data = client.link.connect_email_auth_provider(
    email="<email>",
    vital_link_token=token_response.link_token,
)
import com.junction.api.Junction;
import com.junction.api.core.Environment;
import com.junction.api.resources.link.requests.EmailProviderAuthLink;
import com.junction.api.resources.link.requests.LinkTokenExchange;

Junction client = Junction.builder()
    .apiKey("YOUR_API_KEY")
    .environment(Environment.SANDBOX)
    .build();

var tokenResponse = client.link().token(
    LinkTokenExchange.builder()
        .userId("<user_id>")
        .build()
);

var data = client.link().connectEmailAuthProvider(
    "freestyle_libre",
    EmailProviderAuthLink.builder()
        .email("<email>")
        .vitalLinkToken(tokenResponse.getLinkToken())
        .build()
);
import (
    "context"

    junction "github.com/junction-api/junction-go"
    "github.com/junction-api/junction-go/client"
    "github.com/junction-api/junction-go/option"
)

c := client.NewClient(
    option.WithApiKey("YOUR_API_KEY"),
    option.WithBaseURL(junction.Environments.Sandbox),
)

tokenResponse, err := c.Link.Token(context.TODO(), &junction.LinkTokenExchange{
    UserId: "<user_id>",
})
if err != nil {
    return err
}

response, err := c.Link.ConnectEmailAuthProvider(context.TODO(), &junction.EmailProviderAuthLink{
    Provider:       "freestyle_libre",
    Email:          "<email>",
    VitalLinkToken: &tokenResponse.LinkToken,
})
if err != nil {
    return err
}
fmt.Printf("Received data %s\n", response)
{
  "detail": "<unknown>"
}
curl --request POST \
     --url {{BASE_URL}}/v2/link/provider/email/{provider} \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-vital-link-token: <VITAL-LINK-TOKEN>' \
     --data '
{
     "email": "test@email.com",
     "region": "us"
}
'
import { JunctionClient, JunctionEnvironment } from "@junction-api/sdk";

const client = new JunctionClient({
    apiKey: "YOUR_API_KEY",
    environment: JunctionEnvironment.Sandbox,
});

const tokenResponse = await client.link.token({ userId: "<user_id>" });

const data = await client.link.connectEmailAuthProvider({
    provider: "freestyle_libre",
    email: "<email>",
    vitalLinkToken: tokenResponse.linkToken,
});
from junction import Junction
from junction.environment import JunctionEnvironment

client = Junction(
    api_key="YOUR_API_KEY",
    environment=JunctionEnvironment.SANDBOX,
)

token_response = client.link.token(user_id="<user_id>")

data = client.link.connect_email_auth_provider(
    email="<email>",
    vital_link_token=token_response.link_token,
)
import com.junction.api.Junction;
import com.junction.api.core.Environment;
import com.junction.api.resources.link.requests.EmailProviderAuthLink;
import com.junction.api.resources.link.requests.LinkTokenExchange;

Junction client = Junction.builder()
    .apiKey("YOUR_API_KEY")
    .environment(Environment.SANDBOX)
    .build();

var tokenResponse = client.link().token(
    LinkTokenExchange.builder()
        .userId("<user_id>")
        .build()
);

var data = client.link().connectEmailAuthProvider(
    "freestyle_libre",
    EmailProviderAuthLink.builder()
        .email("<email>")
        .vitalLinkToken(tokenResponse.getLinkToken())
        .build()
);
import (
    "context"

    junction "github.com/junction-api/junction-go"
    "github.com/junction-api/junction-go/client"
    "github.com/junction-api/junction-go/option"
)

c := client.NewClient(
    option.WithApiKey("YOUR_API_KEY"),
    option.WithBaseURL(junction.Environments.Sandbox),
)

tokenResponse, err := c.Link.Token(context.TODO(), &junction.LinkTokenExchange{
    UserId: "<user_id>",
})
if err != nil {
    return err
}

response, err := c.Link.ConnectEmailAuthProvider(context.TODO(), &junction.EmailProviderAuthLink{
    Provider:       "freestyle_libre",
    Email:          "<email>",
    VitalLinkToken: &tokenResponse.LinkToken,
})
if err != nil {
    return err
}
fmt.Printf("Received data %s\n", response)

Authorizations

x-vital-api-key
string
header
required

Headers

x-vital-link-token
string | null

Path Parameters

provider
enum<string>
required

ℹ️ This enum is non-exhaustive.

Available options:
freestyle_libre

Body

application/json
email
string
required
provider
enum<string> | null
deprecated

ℹ️ This enum is non-exhaustive.

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
region
enum<string>

ℹ️ This enum is non-exhaustive.

Available options:
us,
eu,
de,
fr,
ca,
br,
ar,
cl,
co,
mx,
gb,
ie,
au,
nz,
nl,
at,
be,
bh,
ch,
cz,
dk,
eg,
es,
fi,
gr,
hr,
il,
it,
jo,
kw,
lb,
lu,
no,
om,
pl,
pt,
qa,
sa,
se,
si,
sk,
tr,
za,
in,
sg,
hk,
kr,
ph,
tw

Response

Successful Response