Pipedrive
Note: You'll need to create a new Pipedrive app if you don't already have one.
You'll need the following information to set up your Pipedrive app with Paragon:
- Client ID
- Client Secret
Paragon provides a redirect URL to send information to your Pipedrive app. To add the redirect URL to your ServiceNow app:
- 1.
- 2.Navigate to Tools > Marketplace manager and select your application. You can press the green Create new app button if you don't already have one.
- 3.Under OAuth & Access scopes > Callback URL, provide the URL of your Redirect Page.While testing your integration, you can use
https://passport.useparagon.com/oauth
. Once you set up a Redirect Page to go live, you will need to change this to the URL of your Redirect Page.
Pipedrive provides you with the Client ID and Client Secret needed for the next steps after adding the redirect URL to your project.
1. Select Pipedrive from the Integrations Catalog.
2. Under Integrations > Connected Integrations > {YOUR_APP} > Settings, fill out your credentials from the end of Step 1 in their respective sections:
- Client ID:
- Navigate to Tools > Marketplace manager and select your application.
- Under OAuth & Access scopes, copy the Client ID.
- Client Secret:
- Navigate to Tools > Marketplace manager and select your application.
- Under OAuth & Access scopes, copy the Client Secret.
Press the blue "Connect" button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.

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.
// You can find your project ID in the Overview tab of any Integration
// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
// Get all persons
await paragon.request("pipedrive", "/persons", {
method: "GET",
});
// Create a person
await paragon.request("pipedrive", "/persons", {
method: "POST",
body: {
"name": "David Bowie",
"email": "[email protected]"
}
});
Once your Pipedrive account is connected, you can add steps to perform the following actions:
- Create Record
- Update Record
- Get Record by ID
- Get Records
- Delete Record
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:
- 1.
- 2.Navigate to Tools > Marketplace manager and select your application.
- 3.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.
- Note: If a user is not yet logged into your app, Pipedrive's requirements suggest that you redirect to a login form, while preserving the intended URL to redirect to upon successful login. In other words, after logging in, your user should see your Redirect Page.
- Accept and read query parameters, which will be:
code
in case of a successful installationerror
in case of an unsuccessful installation or denied consent
- If the
code
query parameter is present,- Call
paragon.completeInstall
to complete the OAuth exchange and save a new connected Pipedrive account.
paragon.completeInstall("pipedrive", {
authorizationCode: codeQueryParam,
redirectUrl: "https://your-app.url/pipedrive-redirect"
}).then(() => {
// Redirect to your app's integrations page
});
- If the
error
query parameter is present,- Show this error in your app and allow your user to retry the process.
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:- 1.
- 2.Navigate to Tools > Marketplace manager and select your application.
- 3.Under OAuth & Access scopes > Callback URL, provide the URL of your Redirect Page.
Last modified 28d ago