Link Errors

Error delivery

URL Query

Junction performs a 307 Temporary Redirect to the redirect_url specified in your Link Token in the following scenarios:

All connections via the Junction Link widget
Connect OAuth Provider endpoint used by your Custom Widget

Error parameters would be appended to the redirect_url before the redirection. For example, given a redirect_url of https://example.com/vital/callback:

https://example.com/vital/callback
?state=error
&error_type=provider_credential_error
&error=Invalid%20username%20or%20password
&provider=oura
&isMobile=false

provider is included when the provider is known, and isMobile is included when the client context is available. Treat both parameters as optional because some errors occur before Junction Link has that context. When included, provider contains the provider slug and isMobile is the string true or false. Each Junction-generated parameter appears once. Junction preserves existing non-empty query parameters that do not conflict with Link parameters. If Junction generates a parameter already present in the supplied redirect_url, the generated value replaces it. Do not rely on query parameter ordering.

JSON Response

Junction responds 200 OK with a JSON response in the following scenarios:

Connect Password Provider endpoint used by your Custom Widget
Connect Email Provider endpoint used by your Custom Widget

Error parameters would be embedded into the JSON response. For example:

{
  "state": "error",
  "error_type": "provider_credential_error",
  "error": "Invalid username or password"
}

Error Parameters

const string

Constant: error

string

One of the Link Error Types.

string

A human-readable error explanation for troubleshooting purposes. Your application logic should not rely on this message.

Error Types

This list is non-exhaustive. Your application logic must gracefully handle any unrecognized error type.

Error Type	Description
`invalid_token`	The Link Token is invalid or malformed.
`token_expired`	The Link Token has expired.
`token_consumed`	A successful connection establishment has consumed this Link Token.
`provider_credential_error`	OAuth: An error occurred during the provider authentication flow. Password & Email: The supplied user credential is invalid.
`provider_password_expired`	The supplied password has expired due to the password rotation policy of the provider. The user must rotate their password directly with the provider before trying to connect again. Applicable only to the patient-based `abbott_libreview` integration.
`provider_api_error`	An unexpected error occurred when Junction Link attempts to connect to the provider API.
`unsupported_region`	The region you specified is not supported. Applicable only to the practice-based `freestyle_libre` integration.
`duplicate_connection`	The provider credential has an existing connection to a different user in your team. Applicable only if you have opted in to the `reject_duplicate_connection` team setting.
`required_scopes_not_granted`	User did not grant all required scopes, so Junction cannot establish the connection.
`incorrect_mfa_code`	The MFA code entered is incorrect.

Bring Your Own OAuth

Junction iOS App

Providers

Connecting Providers

Device Data

Mobile SDKs

Provider Guides

Error delivery

URL Query

JSON Response

Error Parameters

Error Types

​Error delivery

​URL Query

​JSON Response

​Error Parameters

​Error Types

Error delivery

URL Query

JSON Response

Error Parameters

Error Types