## Pipedrive integration

Pipedrive is a sales-focused CRM platform that helps teams manage deals, contacts, activities, and pipelines. Integrating Pipedrive with Frontegg allows your application to read and write CRM data — including deals, contacts, organizations, and activities — on behalf of your users through OAuth 2.0 authentication.

Prerequisites
- A Pipedrive account with admin access
- Access to the [Pipedrive Developer Hub](https://developers.pipedrive.com/)


### Connect Pipedrive

#### Step 1: Open the developer portal

Navigate to [developers.pipedrive.com](https://developers.pipedrive.com/) to access Pipedrive's developer resources.

![Pipedrive developer portal homepage](/assets/pipedrive-1.049df217085101eea17b5962584bc8e491565c018c005234c77d092348017353.1ce25488.png)

#### Step 2: Open the Developer Hub

Log in to your Pipedrive account at [app.pipedrive.com](https://app.pipedrive.com/auth/login), then navigate to **Developer Hub** in your account settings. You can also access it directly at `app.pipedrive.com/developer-hub`. This page lists all your existing apps and provides tools to create new ones.

![Pipedrive Developer Hub with Create an app button](/assets/pipedrive-2.b3b155c0a4eeaa6d16ddbe8444d01093b415f739f669e8f401c90a7dd385360b.1ce25488.png)

#### Step 3: Create a new app

Click **Create an app**. In the dialog that appears, select **Create public app** to create an OAuth app that can be installed by any Pipedrive user.

![Pipedrive app type selection dialog](/assets/pipedrive-3.f1f1dddb27193a9cfabcad8f8c2e11447632e07d371667595e1c6d550153cf5b.1ce25488.png)

#### Step 4: Fill in the basic info

On the **Basic info** page, enter the following details:

- **App name** — Enter a name for your application, for example `Frontegg Integration`.
- **Callback URL** — Enter the Frontegg redirect URI:



```
https://YOUR_MCP_GATEWAY_URL/integration-callback
```

Click **Save** to proceed to the OAuth & access scopes configuration.

![Pipedrive app basic info form](/assets/pipedrive-4.977b4f6b612393d1083c8e6b1b8f01f8a132520e3af03c9e63e80a9961ffd053.1ce25488.png)

#### Step 5: Configure OAuth scopes

After saving, Pipedrive automatically navigates to the **OAuth & access scopes** section. Enable the scopes your integration requires by toggling them on and selecting the appropriate access level (**Read only** or **Full access**):

| Scope | Description |
|  --- | --- |
| `base` | Basic access to Pipedrive (enabled by default) |
| `deals:full` | Full access to deals |
| `contacts:full` | Full access to contacts (persons and organizations) |
| `activities:full` | Full access to activities |
| `mail:full` | Full access to mail |
| `products:full` | Full access to products |
| `users:read` | Read access to users |


Minimum required scopes
For basic CRM functionality, you need: `base`, `deals:read`, `contacts:read`, `activities:read`.

![Pipedrive OAuth scopes configuration](/assets/pipedrive-5.8d313b300033d59787e3cd3a8952cbe77f293f887f20886776d16c75b97a27a4.1ce25488.png)

#### Step 6: Copy your credentials

After configuring the scopes, click **Save**. Scroll down to the **Client ID** and **Client secret** fields:

- **Client ID** — Your app's unique identifier used to initiate OAuth flows.
- **Client secret** — Click **Show** to reveal the secret. Used to exchange authorization codes for access tokens.


Copy both values and store them securely.

Keep your credentials secure
Never share or commit your Client secret to version control.

![Pipedrive app credentials](/assets/pipedrive-6.113d837e17759d57a2d782d462f0d6a8493412c8861fa1d50dd5fd41439cfe02.1ce25488.png)

### Configure the Frontegg portal

Once you have obtained your **Client ID** and **Client secret** from the steps above, enter them in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Pipedrive.
2. Enter the **Client ID** and **Client secret** in the corresponding fields.
3. Select the required **scopes**.
4. Click **Save**.


### Additional resources

- [Pipedrive API documentation](https://developers.pipedrive.com/docs/api/v1)
- [Pipedrive OAuth guide](https://pipedrive.readme.io/docs/marketplace-oauth-authorization)
- [Pipedrive developer portal](https://developers.pipedrive.com/)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)