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

# Configure Pipedrive

> Configure data exchange and install the CloudTalk CTI to ensure your data stays up to date and your team can call directly from Pipedrive.

<Note>
  This article explains how to connect Pipedrive to CloudTalk, configure syncing and logging settings, set up CloudTalk calling inside Pipedrive (CTI or Click-to-Call), and disconnect the integration if needed.
</Note>

**User level:** Admin

***

<h2 id="h_9c9d0bc504">
  Prerequisites
</h2>

Before you begin, make sure you have the following:

* Active CloudTalk account

* Active Pipedrive account

* Pipedrive Admin permissions to complete setup and configure fields used for syncing

* Access to the CloudTalk Dashboard

* Ability to authorize applications in Pipedrive

* The email address you use in CloudTalk must match exactly with the email address in your Pipedrive account. If the emails do not match, synchronization will not work correctly.

* Each agent must have a phone number added to their CloudTalk profile. If an agent has no phone number, their calls will not be logged to Pipedrive. The calls are skipped without any error message.

<h2 id="h_7da8322afb">
  Connect Pipedrive to CloudTalk
</h2>

1. In CloudTalk Dashboard, go to to **Account** > **Integrations**.

2. Hover over the **Pipedrive** integration and select **`+ Add`**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/79e8516d930f-screenshot-2026-02-13-at-13-00-58.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=25c7087b2b2f77da04604be454e676b2" alt="" width="250" data-path="images/help-center/articles/2843578/79e8516d930f-screenshot-2026-02-13-at-13-00-58.png" />
</Frame>

3\. In the Pipedrive authorization window, click **Allow and Install** to grant permissions..

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/0a900d5197fc-screenshot-2025-03-25-at-10-09-55.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=fc8ead1d540f5700621922e240684bf2" alt="" width="400" data-path="images/help-center/articles/2843578/0a900d5197fc-screenshot-2025-03-25-at-10-09-55.png" />
</Frame>

4\. After successful authentication, you'll be redirected back to CloudTalk.

5\. Click **Save** to activate the integration.

After activation, the initial sync starts.

<h2 id="h_e4b6084483">
  Integration Customization
</h2>

<h3 id="h_8ca89434dd">
  Contact Sync with Pipedrive Organizations (Required for organization-based sync)
</h3>

To create CloudTalk contacts from **Pipedrive Organizations**, Pipedrive must have organization fields available for phone numbers and emails during the initial setup.

1. In Pipedrive, click your profile picture and go to **Company settings**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/b700fb3f118d-screenshot-2025-03-25-at-10-22-40.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=80b64e21ae2fe8cc8d23e7bf3963815e" alt="" width="300" data-path="images/help-center/articles/2843578/b700fb3f118d-screenshot-2025-03-25-at-10-22-40.png" />
   </Frame>

2. From the **Data fields** page, select **Organization**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/c6fbd232398b-screenshot-2025-03-25-at-10-35-37.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=720a2405a07d3cb14b4faef42f242a87" alt="" width="2614" height="1031" data-path="images/help-center/articles/2843578/c6fbd232398b-screenshot-2025-03-25-at-10-35-37.png" />
   </Frame>

3. Select **`Add custom field`**.

   1. Within the box that pops up, choose your settings and name for a custom phone field, choosing **Phone** for **Field type (required)**. **`Save`**.

      <Frame>
        <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/407ca692026b-add-org-field-phone.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=814294d62a353801521935b63d776e0c" alt="" width="1507" height="938" data-path="images/help-center/articles/2843578/407ca692026b-add-org-field-phone.png" />
      </Frame>

4. Set up an email field by clicking the green button to add another **Organization field**, and this time set the field type to **Text**. **`Save`**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/c9720e7de4bf-screenshot-2025-03-25-at-10-53-09.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=7d669c8ffd23e294b0f7997c367b0b6f" alt="" width="1616" height="1259" data-path="images/help-center/articles/2843578/c9720e7de4bf-screenshot-2025-03-25-at-10-53-09.png" />
   </Frame>

5. Open your CloudTalk Dashboard in a new tab. From **Account > Integrations**, select **Proceed** within your Pipedrive integration page if you have not yet done so.

6. Under *General Settings*, you will see **Contact Sync**, **Contact Phone Number**, and **Contact Email Address** with dropdown box options. Here, you can select the Pipedrive Organization fields where the Phone Number & Email Address are stored.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/8a9e608a1335-image.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=45796995c396ac1558634d96fd78d3be" alt="" width="2834" height="680" data-path="images/help-center/articles/2843578/8a9e608a1335-image.png" />
   </Frame>

7. **Save** the integration settings.

<Note>
  Learn more about [custom fields in Pipedrive](https://support.pipedrive.com/en/article/custom-fields), or see an overview of [the field types](https://support.pipedrive.com/en/article/what-types-of-custom-fields-are-there) available.
</Note>

<h3 id="h_84a142a471">
  Call Logging Settings
</h3>

In the **Workflow Settings** section of the Pipedrive integration, you can define how different call types are logged as activities in Pipedrive.

For each call type (such as outbound answered or outbound unanswered), you can:

* Enable or disable logging

* Choose how the call should be logged (for example, as a completed activity)

* Select the activity type that should be assigned in Pipedrive

These settings determine how calls appear and are categorized inside Pipedrive.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/031583b0a8eb-screenshot-2026-02-13-at-13-15-20.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=00ae67ef96278111513e07d643063cf4" alt="" width="2348" height="900" data-path="images/help-center/articles/2843578/031583b0a8eb-screenshot-2026-02-13-at-13-15-20.png" />
</Frame>

You can decide whether you want to **log all calls** or **only calls made during business hours**, and where to assign **missed calls** and customize how **new contacts are created for unassociated numbers**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/d184da4423c2-image.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=e41def4a3eac3dc5e268a6ffa5dc533c" alt="" width="2624" height="556" data-path="images/help-center/articles/2843578/d184da4423c2-image.png" />
</Frame>

Enable **VoiceAgent call logging** to export VoiceAgent calls and captured data (like order numbers or selected plans) to Pipedrive. These calls will be labeled "Voice Agent Call".

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/124428fd564b-screenshot-2025-07-24-at-10-05-11.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=6e8c51cb65ae4b6c60a8f61253e4c972" alt="" width="2142" height="254" data-path="images/help-center/articles/2843578/124428fd564b-screenshot-2025-07-24-at-10-05-11.png" />
</Frame>

<h2 id="h_a5492483d1">
  Install CloudTalk Calling in Pipedrive
</h2>

Pipedrive supports calling via:

* **[CloudTalk CTI](/en/articles/13385830-cloudtalk-cti) (recommended)** as the default calling app in Pipedrive, or

* **[CloudTalk Click-to-Call extension](/en/articles/2964244-the-click-to-call-extension)** (alternative)

<Note>
  For end-user calling instructions, see: **[How to Use CloudTalk with Pipedrive](/en/articles/5360220-using-cloudtalk-with-pipedrive#:~:text=contact%20or%20deal.-,Making%20and%20Receiving%20Calls,-Outbound%20Calls).**
</Note>

<h3 id="h_fcf978fea8">
  Option A: Use Pipedrive CTI (recommended)
</h3>

Pipedrive can start calls from the browser when users click a phone number. You can set CloudTalk as the **Default calling app**.

<h4 id="h_c7b848060a">
  Agent setup:
</h4>

1. Navigate to **Tools and apps** by clicking your profile icon. Under *Tools*, select **Phone calls**.

2. In the *Personal* tab, you can choose your Default calling app. Expand the dropdown and select **CloudTalk**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/663a32273b0b-screenshot-2025-03-25-at-10-56-56.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=488d31f9ddb9e05d7ab6bd8464bde5bd" alt="" width="2595" height="1407" data-path="images/help-center/articles/2843578/663a32273b0b-screenshot-2025-03-25-at-10-56-56.png" />
   </Frame>

Click **`Save`**` settings` to confirm changes.

<h4 id="h_78ee5b6cf3">
  CTI Behavior for Inbound Calls
</h4>

When an inbound call rings, CloudTalk's CTI can automatically open either the Pipedrive person (contact) or their most recently updated open deal, so agents can immediately access relevant context.

In CTI Settings, the user can choose which page is opened for inbound calls:

* Contact Profile (default)

* Latest Open Deal

* Do not open a new page

CTI will match the CloudTalk contact based on the **Pipedrive contact ID** or the most recently updated **open deal**.

* If a match is found, CTI opens the **selected page type** (contact or deal).

* If the CloudTalk contact has **no associated Pipedrive contact ID**, no page is opened.

* If a deal cannot be identified but a contact match exists, the **contact page is opened**, even if "deal" is selected.

* If neither a deal nor a contact can be matched, no page is opened**.**

<h3 id="h_63be462278">
  Option B: Use Click-to-Call extension (alternative)
</h3>

If you use Click-to-Call, install and configure the CloudTalk Click-to-Call extension. To avoid conflicts, disable Pipedrive's default calling method.

<h4 id="h_cc2392a257">
  Steps:
</h4>

1. In Pipedrive, go to **Tools and apps > Phone calls**.

2. For **Default calling app**, select **Custom**, and enter the value using the `ct+tel:` scheme followed by the phone number.

   1. Example: **`ct+tel:555555555`** *.*

      <Frame>
        <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/a047d5b8598b-screenshot-2025-03-25-at-11-48-16.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=eb6520ae83fc92200db73bfe3035aa5e" alt="" width="2617" height="967" data-path="images/help-center/articles/2843578/a047d5b8598b-screenshot-2025-03-25-at-11-48-16.png" />
      </Frame>

3. Click on the **Save settings** button to confirm changes.

<h2 id="h_aea389ace2">
  Disconnect or Remove the Integration
</h2>

If you no longer want CloudTalk to synchronize data with Pipedrive, you can disable or permanently remove the integration.

To **disable the integration**, go to **Account > Integrations**, locate the **Pipedrive** integration, and toggle the status from **Active** to **Inactive**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/89b8b4e133ef-screenshot-2026-04-29-at-14-07-44.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=d782cbeb8e60737e6251a2f6e6317cb2" alt="" width="2072" height="438" data-path="images/help-center/articles/2843578/89b8b4e133ef-screenshot-2026-04-29-at-14-07-44.png" />
</Frame>

To **delete the integration permanently**, open the Pipedrive integration settings, scroll down, click **Delete Integration**, and type **DELETE** to confirm.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2843578/7b284460e9bb-image.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=cac0f4213422fe81436b982d00341844" alt="" width="400" data-path="images/help-center/articles/2843578/7b284460e9bb-image.png" />
</Frame>

After removal:

* Contact sync stops

* Call and message export stops

* Previously exported data remains in Pipedrive

* Existing CloudTalk contacts are not deleted

***

*Need help or have a question?* Just reach out through our [Support portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we're here for you.


## Related topics

- [Using CloudTalk with Pipedrive](/en/articles/5360220-using-cloudtalk-with-pipedrive.md)
- [Send CloudTalk SMS from Pipedrive via Automation](/en/articles/14594584-send-cloudtalk-sms-from-pipedrive-via-automation.md)
- [Pipedrive Deal Stage: Zapier Automation](/en/articles/5724062-pipedrive-deal-stage-zapier-automation.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.