# Linking Pipedrive as a source - Docs

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_9608fcca70)

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_dark_a92b0e022d)

Let AI connect your sources for you

Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.

`npx @posthog/wizard warehouse`

[Learn more](/wizard.md)

![PostHog Wizard hedgehog](https://res.cloudinary.com/dmukukwp6/image/upload/wizard_3f8bb7a240.png)

**Alpha release**

This source is currently in **alpha**. The interface and available tables may change.

The Pipedrive connector syncs your CRM data – deals, persons, organizations, products, pipelines, stages, activities, notes, leads, users, and field metadata – into PostHog.

## Adding a data source

1.  Go to the [sources tab](https://app.posthog.com/data-management/sources) of the data pipeline section in PostHog.

2.  Click **\+ New source** and then click **Link** next to Pipedrive.

3.  Enter your **Company domain**. This is the subdomain of your Pipedrive account URL. For example, if your Pipedrive URL is `https://mycompany.pipedrive.com`, enter `mycompany`. You can also paste the full URL – PostHog normalizes it automatically.

4.  Next, you need an API token from Pipedrive. In your Pipedrive account, go to **Settings** > **Personal preferences** > **API**. Copy your personal API token. The token inherits your user's permissions, so make sure your user can access the data you want to sync.

5.  Back in PostHog, paste the API token in the **API token** field and click **Next**.

6.  Select the tables you want to sync, set the sync frequency, then click **Import**.

Once the syncs are complete, you can start using Pipedrive data in PostHog.

## Available tables

| Table | Description | Sync method |
| --- | --- | --- |
| deals | Sales deals in your Pipedrive account | Full refresh |
| persons | Contact persons | Full refresh |
| organizations | Organizations linked to deals and persons | Full refresh |
| products | Products available in your catalog | Full refresh |
| pipelines | Sales pipelines | Full refresh |
| stages | Stages within pipelines | Full refresh |
| activities | Activities like calls, meetings, and tasks | Full refresh |
| notes | Notes attached to deals, persons, or organizations | Full refresh |
| leads | Sales leads | Full refresh |
| users | Users in your Pipedrive account | Full refresh |
| deal_fields | Custom field definitions for deals | Full refresh |
| person_fields | Custom field definitions for persons | Full refresh |
| organization_fields | Custom field definitions for organizations | Full refresh |

**Full refresh** tables reload all data on each sync.

## Configuration

| Option | Type | Required |
| --- | --- | --- |
| Company domain | text | Yes |
| API token | password | Yes |

## Supported tables

| Table | Description | Sync method | Incremental field | Primary key |
| --- | --- | --- | --- | --- |
| deals | A sales deal (opportunity) tracked in Pipedrive, with its value, stage, and status. | Full refresh | — | — |
| persons | A contact person stored in Pipedrive, with their contact details and links to deals. | Full refresh | — | — |
| organizations | A company or organization stored in Pipedrive, grouping its people and deals. | Full refresh | — | — |
| products | A product or service that can be attached to deals in Pipedrive. | Full refresh | — | — |
| pipelines | A sales pipeline — an ordered set of stages deals move through. | Full refresh | — | — |
| stages | A stage within a pipeline that deals progress through. | Full refresh | — | — |
| notes | A free-text note attached to a deal, person, or organization in Pipedrive. | Full refresh | — | — |
| leads | An inbound lead in Pipedrive that has not yet been converted into a deal. | Full refresh | — | — |
| users | A user (team member) of the Pipedrive account. | Full refresh | — | — |
| deal_fields | A field definition (standard or custom) available on deals in Pipedrive. | Full refresh | — | — |
| person_fields | A field definition (standard or custom) available on persons in Pipedrive. | Full refresh | — | — |
| organization_fields | A field definition (standard or custom) available on organizations in Pipedrive. | Full refresh | — | — |
| activities | A scheduled or logged activity (call, meeting, task, email) linked to deals or contacts. | Full refresh | — | — |

### Community questions

Ask a question

### Was this page useful?

HelpfulCould be better