> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.airweave.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airweave.ai/_mcp/server.

# Pipedrive

> Pipedrive integration with Airweave

{/* AUTO-GENERATED CONTENT START */}

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/airweave.docs.buildwithfern.com/2026-05-20T11%3A36%3A51.367Z/docs/pages/connectors/pipedrive/icon.svg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260807%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260807T162812Z&X-Amz-Expires=604800&X-Amz-Signature=3ca1d89d40f51b0482a1b4419fa41cd761704f083bd8581f78813de0dd3d8970&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="Pipedrive logo" width="48" height="48" />

<h1>
  Pipedrive
</h1>

This connector enables AI agents and RAG systems to retrieve context from Pipedrive through Airweave's unified search layer.

## Configuration

Pipedrive source connector integrates with the Pipedrive CRM API to extract CRM data.

Synchronizes customer relationship management data including persons, organizations,
deals, activities, products, leads, and notes.

Uses API token authentication.

#### [View Source Code](https://github.com/airweave-ai/airweave/tree/main/backend/airweave/platform/sources/pipedrive.py)

Explore the Pipedrive connector implementation

### Authentication

**Supported authentication methods:**

* Direct Credentials

### Configuration Options

This connector does not have any additional configuration options.

## Data Models

The following data models are available for this connector:

#### PipedrivePersonEntity

Schema for Pipedrive person (contact) entities.

Reference:
[https://developers.pipedrive.com/docs/api/v1/Persons](https://developers.pipedrive.com/docs/api/v1/Persons)

| Field              | Type            | Description                                  |
| ------------------ | --------------- | -------------------------------------------- |
| person\_id         | str             | The Pipedrive person ID.                     |
| display\_name      | str             | Display name of the person.                  |
| created\_time      | datetime        | When the person was created.                 |
| updated\_time      | datetime        | When the person was last updated.            |
| first\_name        | Optional\[str]  | The person's first name.                     |
| last\_name         | Optional\[str]  | The person's last name.                      |
| email              | Optional\[str]  | Primary email address.                       |
| phone              | Optional\[str]  | Primary phone number.                        |
| organization\_id   | Optional\[int]  | ID of the linked organization.               |
| organization\_name | Optional\[str]  | Name of the linked organization.             |
| owner\_id          | Optional\[int]  | ID of the user who owns the person.          |
| properties         | Dict\[str, Any] | All properties from Pipedrive person object. |
| active\_flag       | bool            | Whether the person is active.                |
| web\_url\_value    | Optional\[str]  | URL to view this person in Pipedrive.        |

#### PipedriveOrganizationEntity

Schema for Pipedrive organization (company) entities.

Reference:
[https://developers.pipedrive.com/docs/api/v1/Organizations](https://developers.pipedrive.com/docs/api/v1/Organizations)

| Field              | Type            | Description                                        |
| ------------------ | --------------- | -------------------------------------------------- |
| organization\_id   | str             | The Pipedrive organization ID.                     |
| organization\_name | str             | Name of the organization.                          |
| created\_time      | datetime        | When the organization was created.                 |
| updated\_time      | datetime        | When the organization was last updated.            |
| address            | Optional\[str]  | Organization address.                              |
| owner\_id          | Optional\[int]  | ID of the user who owns the organization.          |
| people\_count      | Optional\[int]  | Number of people linked to the organization.       |
| properties         | Dict\[str, Any] | All properties from Pipedrive organization object. |
| active\_flag       | bool            | Whether the organization is active.                |
| web\_url\_value    | Optional\[str]  | URL to view this organization in Pipedrive.        |

#### PipedriveDealEntity

Schema for Pipedrive deal entities.

Reference:
[https://developers.pipedrive.com/docs/api/v1/Deals](https://developers.pipedrive.com/docs/api/v1/Deals)

| Field                 | Type                | Description                                    |
| --------------------- | ------------------- | ---------------------------------------------- |
| deal\_id              | str                 | The Pipedrive deal ID.                         |
| deal\_title           | str                 | Title of the deal.                             |
| created\_time         | datetime            | When the deal was created.                     |
| updated\_time         | datetime            | When the deal was last updated.                |
| value                 | Optional\[float]    | Monetary value of the deal.                    |
| currency              | Optional\[str]      | Currency of the deal value.                    |
| status                | Optional\[str]      | Status of the deal (open, won, lost, deleted). |
| stage\_id             | Optional\[int]      | ID of the pipeline stage.                      |
| stage\_name           | Optional\[str]      | Name of the pipeline stage.                    |
| pipeline\_id          | Optional\[int]      | ID of the pipeline.                            |
| pipeline\_name        | Optional\[str]      | Name of the pipeline.                          |
| person\_id            | Optional\[int]      | ID of the linked person.                       |
| person\_name          | Optional\[str]      | Name of the linked person.                     |
| organization\_id      | Optional\[int]      | ID of the linked organization.                 |
| organization\_name    | Optional\[str]      | Name of the linked organization.               |
| owner\_id             | Optional\[int]      | ID of the user who owns the deal.              |
| expected\_close\_date | Optional\[datetime] | Expected close date of the deal.               |
| probability           | Optional\[float]    | Deal success probability (0-100).              |
| properties            | Dict\[str, Any]     | All properties from Pipedrive deal object.     |
| active\_flag          | bool                | Whether the deal is active.                    |
| web\_url\_value       | Optional\[str]      | URL to view this deal in Pipedrive.            |

#### PipedriveActivityEntity

Schema for Pipedrive activity entities (tasks, calls, meetings).

Reference:
[https://developers.pipedrive.com/docs/api/v1/Activities](https://developers.pipedrive.com/docs/api/v1/Activities)

| Field              | Type                | Description                                    |
| ------------------ | ------------------- | ---------------------------------------------- |
| activity\_id       | str                 | The Pipedrive activity ID.                     |
| activity\_subject  | str                 | Subject/title of the activity.                 |
| created\_time      | datetime            | When the activity was created.                 |
| updated\_time      | datetime            | When the activity was last updated.            |
| activity\_type     | Optional\[str]      | Type of activity (call, meeting, task, etc.).  |
| due\_date          | Optional\[datetime] | Due date of the activity.                      |
| due\_time          | Optional\[str]      | Due time of the activity.                      |
| duration           | Optional\[str]      | Duration of the activity.                      |
| done               | bool                | Whether the activity is done.                  |
| note               | Optional\[str]      | Note/description of the activity.              |
| deal\_id           | Optional\[int]      | ID of the linked deal.                         |
| deal\_title        | Optional\[str]      | Title of the linked deal.                      |
| person\_id         | Optional\[int]      | ID of the linked person.                       |
| person\_name       | Optional\[str]      | Name of the linked person.                     |
| organization\_id   | Optional\[int]      | ID of the linked organization.                 |
| organization\_name | Optional\[str]      | Name of the linked organization.               |
| owner\_id          | Optional\[int]      | ID of the user who owns the activity.          |
| properties         | Dict\[str, Any]     | All properties from Pipedrive activity object. |
| active\_flag       | bool                | Whether the activity is active.                |
| web\_url\_value    | Optional\[str]      | URL to view this activity in Pipedrive.        |

#### PipedriveProductEntity

Schema for Pipedrive product entities.

Reference:
[https://developers.pipedrive.com/docs/api/v1/Products](https://developers.pipedrive.com/docs/api/v1/Products)

| Field           | Type             | Description                                   |
| --------------- | ---------------- | --------------------------------------------- |
| product\_id     | str              | The Pipedrive product ID.                     |
| product\_name   | str              | Name of the product.                          |
| created\_time   | datetime         | When the product was created.                 |
| updated\_time   | datetime         | When the product was last updated.            |
| code            | Optional\[str]   | Product code/SKU.                             |
| description     | Optional\[str]   | Product description.                          |
| unit            | Optional\[str]   | Unit of the product.                          |
| tax             | Optional\[float] | Tax percentage.                               |
| category        | Optional\[str]   | Product category.                             |
| owner\_id       | Optional\[int]   | ID of the user who owns the product.          |
| prices          | Dict\[str, Any]  | Product prices in different currencies.       |
| properties      | Dict\[str, Any]  | All properties from Pipedrive product object. |
| active\_flag    | bool             | Whether the product is active.                |
| web\_url\_value | Optional\[str]   | URL to view this product in Pipedrive.        |

#### PipedriveLeadEntity

Schema for Pipedrive lead entities.

Reference:
[https://developers.pipedrive.com/docs/api/v1/Leads](https://developers.pipedrive.com/docs/api/v1/Leads)

| Field                 | Type                  | Description                                |
| --------------------- | --------------------- | ------------------------------------------ |
| lead\_id              | str                   | The Pipedrive lead ID.                     |
| lead\_title           | str                   | Title of the lead.                         |
| created\_time         | datetime              | When the lead was created.                 |
| updated\_time         | datetime              | When the lead was last updated.            |
| value                 | Optional\[float]      | Potential value of the lead.               |
| currency              | Optional\[str]        | Currency of the lead value.                |
| expected\_close\_date | Optional\[datetime]   | Expected close date.                       |
| person\_id            | Optional\[int]        | ID of the linked person.                   |
| person\_name          | Optional\[str]        | Name of the linked person.                 |
| organization\_id      | Optional\[int]        | ID of the linked organization.             |
| organization\_name    | Optional\[str]        | Name of the linked organization.           |
| owner\_id             | Optional\[int]        | ID of the user who owns the lead.          |
| source\_name          | Optional\[str]        | Source of the lead.                        |
| label\_ids            | Optional\[List\[str]] | List of label IDs.                         |
| properties            | Dict\[str, Any]       | All properties from Pipedrive lead object. |
| is\_archived          | bool                  | Whether the lead is archived.              |
| web\_url\_value       | Optional\[str]        | URL to view this lead in Pipedrive.        |

#### PipedriveNoteEntity

Schema for Pipedrive note entities.

Reference:
[https://developers.pipedrive.com/docs/api/v1/Notes](https://developers.pipedrive.com/docs/api/v1/Notes)

| Field                          | Type            | Description                                    |
| ------------------------------ | --------------- | ---------------------------------------------- |
| note\_id                       | str             | The Pipedrive note ID.                         |
| note\_title                    | str             | Title/summary of the note.                     |
| created\_time                  | datetime        | When the note was created.                     |
| updated\_time                  | datetime        | When the note was last updated.                |
| content                        | Optional\[str]  | Content of the note.                           |
| deal\_id                       | Optional\[int]  | ID of the linked deal.                         |
| deal\_title                    | Optional\[str]  | Title of the linked deal.                      |
| person\_id                     | Optional\[int]  | ID of the linked person.                       |
| person\_name                   | Optional\[str]  | Name of the linked person.                     |
| organization\_id               | Optional\[int]  | ID of the linked organization.                 |
| organization\_name             | Optional\[str]  | Name of the linked organization.               |
| lead\_id                       | Optional\[str]  | ID of the linked lead.                         |
| user\_id                       | Optional\[int]  | ID of the user who created the note.           |
| pinned\_to\_deal\_flag         | bool            | Whether the note is pinned to a deal.          |
| pinned\_to\_person\_flag       | bool            | Whether the note is pinned to a person.        |
| pinned\_to\_organization\_flag | bool            | Whether the note is pinned to an organization. |
| properties                     | Dict\[str, Any] | All properties from Pipedrive note object.     |
| active\_flag                   | bool            | Whether the note is active.                    |
| web\_url\_value                | Optional\[str]  | URL to view this note in Pipedrive.            |

{/* AUTO-GENERATED CONTENT END */}