Connect data sources

The Thryve Connection Widget allows end users to seamlessly manage data source connections within your application. There is no need for additional views or logic from your side. Simply embed the widget's URL, provided by the API, into your web application. This will display all available data sources and their connection statuses to your users.

Thryve Connection Widget sample for a user connected to Strava

The Connection Widget must be embedded in your app using an iframe component. Opening the URL in a new tab or window will prevent the widget from properly redirecting users back to your web app.

Before requesting the Connection Widget, ensure you create a Thryve user. The returned endUserId (accessToken) is required to generate the Connection Widget.

Returns Thryve Connection Widget for requesting user

post

Header parameters

AuthorizationstringRequired

Basic Auth for your username:password. Required for all endpoints

AppAuthorizationstringRequired

Basic Auth for your authID:authSecret. Required for all endpoints.

Body

endUserIdstringRequired

The end user identifier. The data source connected via the Widget session will be linked to this user.

Example: de3d1e068537dd927b48988cb6969abe

localeundefined · enumOptional

Manually set the language code following ISO 639-1 to set the language that will be used on UI elements, e.g. the Thryve Widget. If not set it will default to english.

Possible values:

Responses

200

Successful response containing URL of Thryve Widget for requesting user.

application/json

typeundefined · enumRequiredPossible values:

400

Bad Request – invalid input parameters.

500

Internal Server Error.

post/widget/v6/connection

POST /widget/v6/connection HTTP/1.1
Host: api.thryve.de
Authorization: text
AppAuthorization: text
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "endUserId": "de3d1e068537dd927b48988cb6969abe",
  "locale": "en"
}

{
  "type": "enduser.widget.connection",
  "data": {
    "url": "https://connect.thryve.de/?connectionSessionToken=0829365171X3728406115992781594&platform=web&lang=en"
  }
}