Connect to your users’ Pipedrive accounts.
To get started, you’ll need to create an app in the Developer Hub of a Pipedrive account.
Click Create an app and select Create public app. Public apps are intended to allow your users to connect their Pipedrive accounts to your app.
Name the app and add https://passport.useparagon.com/oauth as the Callback URL. Click Save.
https://passport.useparagon.com/oauth
as your Callback URL.
Once you set up a Redirect Page to go live, you will need to change this to the URL of your Redirect Page.Configure your app to use the least privileged scopes required for it to function.
Copy the following information to set up your Pipedrive app with Paragon.
Complete configuration within the Paragon Dashboard and test authentication for your integration.
Select Pipedrive from the Integrations Catalog.
Under Integrations > Connected Integrations > Pipedrive > Configure, fill out your OAuth client credentials from the end of Step 1:
Click “Save changes” button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys for user authentication. This is intended for development use only.
You can now test user authentication with the Connect Portal, build workflows, make Pipedrive requests using the SDK, and call Pipedrive ActionKit actions.
Once your users have connected their Pipedrive account, you can use the Paragon SDK to access the Pipedrive API on behalf of connected users.
See the Pipedrive REST API documentation for their full API reference.
Any Pipedrive API endpoints can be accessed with the Paragon SDK as shown in this example.
Once your Pipedrive account is connected, you can add steps to perform the following actions:
When creating or updating records in Pipedrive, you can reference data from previous steps by typing {{
to invoke the variable menu.
To use Pipedrive’s webhook triggers, you’ll need to enable the “Administer account” scope in your Pipedrive application:
Log in to the Pipedrive Developer Portal.
Navigate to Tools > Marketplace manager and select your application.
Under OAuth & Access scopes, enable Administer account.
Required: Setting up a Redirect Page is a requirement for allowing customers outside of your Pipedrive Developer account to connect an integration.
If you do not set up this page, the Pipedrive team will not approve your app for public use.
Your Pipedrive integration requires a Redirect Page hosted in your application to support an installation flow that begins in the Pipedrive Marketplace (i.e., a user searches the Pipedrive Marketplace for your published app and clicks Install).
For an example implementation of the Redirect Page using React (based on our Next.js sample app), see here.
The Redirect Page should be implemented as follows:
Import the Paragon SDK and authenticate a user.
Accept and read query parameters, which will be:
code
in case of a successful installation
error
in case of an unsuccessful installation or denied consent
If the code
query parameter is present,
paragon.completeInstall
to complete the OAuth exchange and save a new connected Pipedrive account.If the error
query parameter is present,
If you were previously testing with https://passport.useparagon.com/oauth
as your Pipedrive Redirect URL, you will need to update this value after implementing a Redirect Page:
Log into your Pipedrive Developer Portal.
Navigate to Tools > Marketplace manager and select your application.
Under OAuth & Access scopes > Callback URL, provide the URL of your Redirect Page.
Connect to your users’ Pipedrive accounts.
To get started, you’ll need to create an app in the Developer Hub of a Pipedrive account.
Click Create an app and select Create public app. Public apps are intended to allow your users to connect their Pipedrive accounts to your app.
Name the app and add https://passport.useparagon.com/oauth as the Callback URL. Click Save.
https://passport.useparagon.com/oauth
as your Callback URL.
Once you set up a Redirect Page to go live, you will need to change this to the URL of your Redirect Page.Configure your app to use the least privileged scopes required for it to function.
Copy the following information to set up your Pipedrive app with Paragon.
Complete configuration within the Paragon Dashboard and test authentication for your integration.
Select Pipedrive from the Integrations Catalog.
Under Integrations > Connected Integrations > Pipedrive > Configure, fill out your OAuth client credentials from the end of Step 1:
Click “Save changes” button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys for user authentication. This is intended for development use only.
You can now test user authentication with the Connect Portal, build workflows, make Pipedrive requests using the SDK, and call Pipedrive ActionKit actions.
Once your users have connected their Pipedrive account, you can use the Paragon SDK to access the Pipedrive API on behalf of connected users.
See the Pipedrive REST API documentation for their full API reference.
Any Pipedrive API endpoints can be accessed with the Paragon SDK as shown in this example.
Once your Pipedrive account is connected, you can add steps to perform the following actions:
When creating or updating records in Pipedrive, you can reference data from previous steps by typing {{
to invoke the variable menu.
To use Pipedrive’s webhook triggers, you’ll need to enable the “Administer account” scope in your Pipedrive application:
Log in to the Pipedrive Developer Portal.
Navigate to Tools > Marketplace manager and select your application.
Under OAuth & Access scopes, enable Administer account.
Required: Setting up a Redirect Page is a requirement for allowing customers outside of your Pipedrive Developer account to connect an integration.
If you do not set up this page, the Pipedrive team will not approve your app for public use.
Your Pipedrive integration requires a Redirect Page hosted in your application to support an installation flow that begins in the Pipedrive Marketplace (i.e., a user searches the Pipedrive Marketplace for your published app and clicks Install).
For an example implementation of the Redirect Page using React (based on our Next.js sample app), see here.
The Redirect Page should be implemented as follows:
Import the Paragon SDK and authenticate a user.
Accept and read query parameters, which will be:
code
in case of a successful installation
error
in case of an unsuccessful installation or denied consent
If the code
query parameter is present,
paragon.completeInstall
to complete the OAuth exchange and save a new connected Pipedrive account.If the error
query parameter is present,
If you were previously testing with https://passport.useparagon.com/oauth
as your Pipedrive Redirect URL, you will need to update this value after implementing a Redirect Page:
Log into your Pipedrive Developer Portal.
Navigate to Tools > Marketplace manager and select your application.
Under OAuth & Access scopes > Callback URL, provide the URL of your Redirect Page.