1

Your Backend

Create a Vital Link Token for a user using the Create Link Token endpoint.

You may want to launch Vital Link for an individual provider. This launches the Vital Link widget straight into the login flow for the specified provider.

To do so, you just pass in the provider name as one of the parameter’s to the link create endpoint.



2

Your Frontend

Use the Link Token to launch the Link Widget on your frontend.

You can launch the Vital Link Widget by its URL:

  • If you have created the Link Token for a specific OAuth provider, Vital Link will dispatch the user automatically to the provider’s sign-in page.

  • Otherwise, your user will be presented with a list of providers to connect to. You can customize the list via the filter_on_providers parameter when creating the Link Token.

EnvironmentURL format
Sandbox UShttps://link.tryvital.io/?token={LINK_TOKEN}&env=sandbox&region=us
Sandbox EUhttps://link.tryvital.io/?token={LINK_TOKEN}&env=sandbox&region=eu
Production UShttps://link.tryvital.io/?token={LINK_TOKEN}&env=production&region=us
Production EUhttps://link.tryvital.io/?token={LINK_TOKEN}&env=production&region=eu

When the Link flow completes, the flow will redirect to the redirect_url you specified earlier when creating the Link Token. We will also append query parameters to the redirection target based on the Link flow outcome:

Flow stateQuery parameters
Successstate=success
ErrorSee Link Errors.