Create Hosted Provider Session

post

https://api.trinsic.id/api/v1/sessions/provider/hosted

Verify a user's identity with a specific provider, using Trinsic-hosted UI for providers which require additional user interaction.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

provider

string

required

length ≥ 1

The ID of the provider to launch

verificationProfileId

uuid

required

The ID of the Verification Profile to use for this session.

redirectUrl

string

required

length ≥ 1

The Redirect URL to which the user should be sent after the session is complete.

enableRedirectBackwardsCompatibility

boolean

required

Defaults to true if not provided. Controls backwards compatibility behavior.

If true, redirectToken validation is not required as part of the Session flow.
If false, redirectToken validation is required as a core part of the Session flow; results cannot be fetched without it.

This parameter exists to enable backwards compatibility with existing integrations. In the future, this parameter will be removed and redirectToken validation will always be required.

If your integration supports redirectToken, you should explicitly set this parameter's value to false.
Only set this value to true if your integration does not support redirectToken and you are not yet able to add support.

browserLanguages

array of strings | null

Preferences for languages to show first in the Hosted UI and supported provider launch
flows. If left empty, the Hosted UI defaults to the user's navigator languages. If no
preferred language is available, the Hosted UI falls back to English.

browserLanguages

providerInput

object | null

deprecated

Provider-specific input for those providers which require it.

Deprecated: In the future, Hosted Provider Sessions will not accept input on creation,

and will instead always redirect the user to a hosted interface to collect input. If you need
to collect input from the user yourself, please use the Create Direct Session endpoint instead.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

200OK

400Bad request

401Unauthorized

403Forbidden

500Internal server error