> ## Documentation Index
> Fetch the complete documentation index at: https://docs.routemcp.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipedrive

> Sync persons, leads, deals, and activities with Pipedrive via OAuth 2.0.

<img src="https://icon.horse/icon/pipedrive.com" alt="Pipedrive" style={{ width: "48px", height: "48px", marginBottom: "16px" }} />

## Overview

| Property    | Value                   |
| ----------- | ----------------------- |
| Slug        | `pipedrive`             |
| Auth        | OAuth 2.0 + PKCE        |
| API version | v1                      |
| Sandbox     | Yes                     |
| Rate limit  | 100 req/min, 10 req/sec |

## Supported resources

| Resource    | List                                      | Get                                       | Create                                    | Update                                    | Delete                                    |
| ----------- | ----------------------------------------- | ----------------------------------------- | ----------------------------------------- | ----------------------------------------- | ----------------------------------------- |
| Contact     | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> |
| Lead        | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> |
| Deal        | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> |
| Meeting     | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> |
| Company     | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> |
| Note        | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> |
| Task        | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> |
| Activity    | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> |
| Pipeline    | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | —                                         | —                                         | —                                         |
| Owner       | <span style={{color: "#16a34a"}}>✓</span> | <span style={{color: "#16a34a"}}>✓</span> | —                                         | —                                         | —                                         |
| Appointment | —                                         | —                                         | —                                         | —                                         | —                                         |

<Info>
  In Pipedrive, **contacts** map to **Persons**, and **meetings** map to **Activities** with `type: meeting`.
</Info>

## Connect setup

Pipedrive uses OAuth 2.0 with PKCE. You need an app from the Pipedrive Marketplace Developer Portal.

<Steps>
  <Step title="Create a Pipedrive marketplace app">
    Go to [Pipedrive Developer Hub](https://developers.pipedrive.com) → **Create app**. Under **OAuth & Access scopes**, copy the **Client ID** and **Client Secret**.
  </Step>

  <Step title="Add the redirect URL">
    In your app's **Callback URL** field, add:

    ```
    https://api.routemcp.io/api/v1/auth/callback
    ```
  </Step>

  <Step title="Configure required scopes">
    Enable the following scopes:

    * `contacts:read`
    * `contacts:write`
    * `leads:read`
    * `leads:write`
    * `deals:read`
    * `deals:write`
    * `activities:read`
    * `activities:write`
    * `users:read`
  </Step>

  <Step title="Connect via the widget">
    When your end user opens the Connect widget, they enter the Client ID and Client Secret, then authorize via Pipedrive OAuth.
  </Step>
</Steps>

## Usage

```bash theme={null}
# List deals from Pipedrive
curl "https://api.routemcp.io/api/v1/crm/deal?provider=pipedrive" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "X-End-User-Id: user-123"

# Update a meeting
curl -X PATCH "https://api.routemcp.io/api/v1/crm/meeting/mtg-001?provider=pipedrive" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -H "X-End-User-Id: user-123" \
  -d '{ "title": "Q2 Review", "start_time": "2026-04-01T10:00:00Z" }'
```

## Notes

* Pipedrive uses cursor-based pagination with up to 500 records per page.
* Owner details (name, email) are resolved via a secondary lookup on `/v1/users/{id}`.
* Use `environment: "sandbox"` in your connect token to route requests to the Pipedrive sandbox.