How to register your own Pipedrive OAuth app

Register an OAuth app with Pipedrive and obtain credentials to connect it to Nango

This guide shows you how to register your own app with Pipedrive to obtain your OAuth credentials (client id & secret). These are required to let your users grant your app access to their Pipedrive account.

Creating a Pipedrive OAuth app

1. Access the Pipedrive Marketplace

   Log in to your Pipedrive account and navigate to the Pipedrive Marketplace Developer Hub.

2. Create a new app

   Click on “Create an app” or “New app” to start the registration process.

3. Configure your app settings

   Fill in the required information for your app:

   • App name: Choose a name for your application
   • Description: Provide a brief description of what your app does
   • OAuth & Access scopes: Select the scopes your application needs
4. Set up OAuth redirect URI

   In the OAuth settings, add your Nango OAuth redirect URI:

   https://api.nango.dev/oauth/callback
   

   For local development, you may also need to add:

   http://localhost:3003/oauth/callback
   
5. Save and obtain credentials

   After saving your app configuration, Pipedrive will generate:

   • Client ID: Your OAuth client identifier
   • Client Secret: Your OAuth client secret

   Copy these credentials - you’ll need them to configure your integration in Nango.

6. Configure the integration in Nango

   In the Nango dashboard:

   1. Go to Integrations
   2. Find and select Pipedrive
   3. Enter your Client ID and Client Secret
   4. Save the configuration

After creating your OAuth app, you may need to submit it for review before it can be used by users outside your organization. Check Pipedrive’s OAuth documentation for details on the app review process.

Understanding Pipedrive scopes

Pipedrive uses OAuth scopes to control what data your application can access. When configuring your app, select only the scopes necessary for your use case.

For a complete list of available scopes and their permissions, see Pipedrive’s scopes documentation.

Connection configuration

Pipedrive requires an api_domain parameter that is returned during the OAuth flow. Nango automatically extracts and stores this value from the token response, so you don’t need to configure it manually.

When making API calls through Nango’s proxy, the correct API domain will be used automatically based on the connection.

For more information on Pipedrive’s OAuth implementation and API concepts, see Pipedrive’s API documentation.

---