Once an integration has been added to the Paragon dashboard, you can now display the Connect Portal for that integration in your application. The Connect Portal is a component that your users interact with to connect their third-party app accounts to your application.

Displaying the Connect Portal in your app

​.authenticate should be called at the beginning of your application's lifecycle in all cases. This is to make sure that the userToken is always as fresh as possible, with respect to your user's existing session on your own site. You may reference Installing the Connect SDK for a detailed explanation on how to use .authenticate.

Example:

paragon.authenticate(
	// You can find your project ID in the Overview tab of any Integration
	"38b1f170-0c43-4eae-9a04-ab85325d99f7",
​
	// See Setup for how to encode your user token
	"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.ey..."
);

Once .authenticate has been called, you can call .connect to launch your Connect Portal for a specific integration provider. You can find the integrationType identifier you need in the Overview page for the integration.

Example:

paragon.connect("salesforce");

You must have an integration configured of this integrationType for the Portal to appear. Otherwise, this function does nothing.

Once your user connects their third-party app account in the Connect Portal, you can access their app account by creating Workflows or via the Paragon API. You can always call .getUser to retrieve the currently authenticated user and their connected integration state.