Junction

Junction Link API

The link API from Vital — 13 operation(s) for link.

GitHub OpenAPI
Business capability
Wearable & Health Data Sync AE-130.20

Operations 13

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v2/link/bulk_import Bulk import existing provider connections · Bulk Import Connections #
Ask an LLM
“Can I import existing device connections for many users at once?”
“Is there a way to migrate already-authorized provider connections in bulk?”
Tell an agent
Bulk import connections {connections} for provider {provider}.
Import these {provider} connections and wait for completion: {connections}.
POST /v2/link/bulk_trigger_historical_pull Trigger historical pulls for many users · Bulk Trigger Historical Pull #
Ask an LLM
“Can I trigger a historical backfill for a batch of users at once?”
“How do I re-pull past data from a provider for a list of users?”
Tell an agent
Trigger historical pulls from {provider} for users {user_ids}.
Backfill {provider} history for {user_ids} and wait until it finishes.
POST /v2/link/bulk_export Export users' provider connections · Bulk Export Connections #
Ask an LLM
“Can I export my users' connections for a provider?”
“Is there a paginated export of provider connections?”
Tell an agent
Export {provider} connections for users {user_ids}.
Continue exporting {provider} connections from token {next_token}.
POST /v2/link/bulk_pause Pause provider connections in bulk · Bulk Pause Connections #
Ask an LLM
“Can I pause data syncing for many users' connections at once?”
“Which call pauses a provider connection for a batch of users?”
Tell an agent
Pause {provider} connections for users {user_ids}.
Stop syncing {provider} for {user_ids} for now.
POST /v2/link/token Generate a Link token to connect a user · Generate Vital Link Token #
Ask an LLM
“How do I start the Vital Link connection flow for one of my users?”
“How long is a link token valid, and can it be reused?”
Tell an agent
Generate a link token for user {user}.
Create a link token for {user} that redirects to {redirect_url} when done.
POST /v2/link/code/create Invite a mobile app user to my team · Create Token #
Ask an LLM
“Can I invite someone using the Vital mobile app to join my team?”
“Can a mobile app invite code be set to expire at a specific time?”
Tell an agent
Create a mobile app invite code for user {q_user}.
Generate a team invite code for {q_user} expiring at {expires_at}.
POST /v2/link/provider/password/{provider} Connect a password-based provider · Connect Password Provider #
Ask an LLM
“Can I connect a provider that signs in with a username and password?”
“Is a region needed when connecting a password-based provider?”
Tell an agent
Connect password provider {path_provider} with username {username} and password {password}.
Link {path_provider} using credentials {username} / {password} in region {region}.
POST /v2/link/provider/password/{provider}/complete_mfa Finish a password provider login with MFA · Complete Password Provider Mfa #
Ask an LLM
“What do I do when a password-based provider asks for an MFA code?”
“Can I finish connecting a provider that sent a two-factor code?”
Tell an agent
Complete MFA for {path_provider} with code {mfa_code}.
Submit verification code {mfa_code} to finish connecting {path_provider}.
POST /v2/link/provider/email/{provider} Connect an email-based provider · Connect Email Auth Provider #
Ask an LLM
“Can I connect a provider that only needs the user's email address?”
“Can I set a region when connecting an email-based provider?”
Tell an agent
Connect email provider {path_provider} for {email}.
Link {path_provider} by email {email} in region {region}.
POST /v2/link/connect/demo Connect a user to a demo provider · Create Demo Connection #
Ask an LLM
“Can I connect a test user to a demo provider to get sample data?”
“Is there a way to simulate a wearable connection without a real device?”
Tell an agent
Connect user {user} to demo provider {provider}.
Create a demo {provider} connection for {user}.

Documentation

📖
Documentation
https://docs.junction.com/api-details/junction-api
📖
Documentation
https://docs.junction.com/wearables/providers/introduction
📖
Documentation
https://docs.junction.com/api-details/junction-management-api

Specifications

⚙
OpenAPI
https://artifacts.apis.io/junction-com/openapi/junction-com-link-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-user-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-provider-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-sleep-summary-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-activity-summary-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-heart-rate-timeseries-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-lab-order-schema.json
📊
JSONSchema
https://artifacts.apis.io/junction-com/json-schema/vital-lab-result-schema.json

Other Resources

🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-create-user-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-link-token-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-sleep-summary-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-heart-rate-timeseries-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-create-order-example.json
🔗
Examples
https://artifacts.apis.io/junction-com/examples/vital-lab-result-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/junction-com:junction-com-link-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

junction-com-link-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Junction Link API
  version: '1.0'
  description: 'Operations tagged link across 2 of this provider''s published API definitions: junction-openapi-live-2026-10-12.json, vital-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.us.junction.com
  x-fern-server-name: Production
- url: https://api.eu.junction.com
  x-fern-server-name: ProductionEU
- url: https://api.sandbox.us.junction.com
  x-fern-server-name: Sandbox
- url: https://api.sandbox.eu.junction.com
  x-fern-server-name: SandboxEU
security:
- apiKeyAuth: []
tags:


# --- truncated at 32 KB (56 KB total) ---
# Full source: https://artifacts.apis.io/junction-com/openapi/junction-com-link-api-openapi.yml