Adding an Integration

Create a developer app

Before adding an integration to Paragon, you'll first need to register a developer app from a third-party app provider that Paragon supports. Once you create your developer app, you'll receive app credentials - usually a Client ID and Secret - that you'll enter in your Paragon dashboard in the next step.

You'll need to specify a redirect URL (sometimes called "callback URL") when configuring your developer app for a third-party provider. Here, you should provide Paragon's redirect URL:

https://passport.useparagon.com/oauth

You can find provider-specific instructions for setting up a developer app and connecting it to Paragon in the Integration Providers section of our docs.

Connect your developer app to Paragon

In your Paragon Connect dashboard, click on Catalog in the sidebar menu and select which integration provider you want to add. Once you select an integration, enter your developer app's credentials - usually a Client ID and Secret.

You can add an integration using Paragon's development keys by leaving the app credentials blank. This should only be used for testing, and you should add your own app credentials for use in production.

Configuring Permissions

Once you add an integration, you can define which permission scopes will be requested from your users under Integration Settings. You'll usually need to make sure the same scopes are defined when configuring your developer app from the third-party app provider.