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

# Pipedrive App

> Install the official Pipedrive app to create or update Pipedrive persons for your Dodo Payments customers and add a note for each payment, refund, and dispute.

## What the Pipedrive app does

The Pipedrive app creates or updates a Pipedrive person for each customer. It also adds a note to the person for each payment, refund, and dispute. The app makes no deals and no organizations, and has no map from a product to a label.

## Before you start

* You are an owner or an admin of the Dodo Payments business.
* You have a Pipedrive account. You have the personal API token of a user that can see and edit all persons.

## Install, connect, and configure

**1. Install the app**

Open **Apps**, then **Explore**. Open **Pipedrive** (publisher **Dodo Payments**) and select **Install app**.

![The Installed tab of Apps with Pipedrive in the list and the status Active](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/pipedrive-4.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=0613e593ae17789887b2049e7249cd58)

**2. Connect Pipedrive**

Select **Connect**. Enter the company domain of your Pipedrive account, for example `acme` for `https://acme.pipedrive.com`. In Pipedrive, open **Personal preferences**, then **API**, and copy your personal API token. Paste it in the **API Token** field, then select **Connect**.

![The Connect Pipedrive dialog with the Company Domain and API Token fields](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/pipedrive-3.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=9866df6fbada5feac703f00f35e7604b)

**3. Make the person fields (optional)**

To use **Write the Dodo person fields**, open **Company settings**, then **Data fields** in Pipedrive. Make three person custom fields of the type Text: `dodo_customer_id`, `dodo_subscription_status`, and `dodo_status_updated_at`. The app refuses the write when a field does not exist.

**4. Choose the settings**

Open the **Configure** tab, set the options, and select **Save**.

![The Configure tab of the Pipedrive app with the three setting switches and the Products filter](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/pipedrive-1.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=0a35585d7e2bf12130ac2a0a232ceb34)

**5. Pick the filters**

Pick the products and currencies, then select **Save**.

![The Pipedrive Configure tab with the Products and Currencies filters](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/pipedrive-2.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=40b9928f27216b9aa74503f492715609)

## Settings

| Setting | What it does | Default |
| - | - | - |
| Add customers as persons | Create or update a person by email for each successful payment and each new or renewed subscription. The app writes the name and the email. | On |
| Write the Dodo person fields | Also write `dodo_customer_id`, `dodo_subscription_status`, and `dodo_status_updated_at`. The app writes the status when a subscription goes on hold, is cancelled, or expires. | Off |
| Add a note for payments, refunds and disputes | Add one note to the person for each successful payment, each successful refund, and each opened dispute. | On |
| Products | Send person data only for the products that you pick. The notes do not use this filter. | All |
| Currencies | Send data only for the currencies that you pick. | All |

## What is sent and when

Dodo Payments sends data after the Dodo Payments event happens. The app sends the email address and the name of the customer. With **Write the Dodo person fields** on, it also sends the customer ID, the subscription status, and the time. A note shows the event, the amount in the major unit with the currency code, the product names, and the Dodo ID. The app sends no card data and no address.

When no person exists, the app creates a person with the name and the email for a note. The app updates the name of an existing person at each payment. A name that you changed in Pipedrive changes back to the name in Dodo Payments.

The Pipedrive search can be late. If two events of a new customer occur at the same time, a second person with the same email can occur. Merge the two persons in Pipedrive.

## Test the app

**1. Use test mode**

Install and connect the app in test mode.

**2. Make a test payment**

Create a test payment with a test customer email.

**3. Check Pipedrive**

Open **Contacts**, then **People** in Pipedrive. The test customer appears. If notes are on, the person has a note for the payment.

## Troubleshooting

| Problem | What to do |
| - | - |
| The connection fails | Copy the personal API token again in Pipedrive. Check the company domain. Pipedrive gives an error for a token that is not valid. |
| Pipedrive refuses the update after you turn on **Write the Dodo person fields** | Make the three person custom fields of the type Text in Pipedrive. |
| A person has the wrong name | The app writes the name of Dodo Payments at each payment. Change the name in Dodo Payments. |
| Two persons exist for one email | The search was late when two events ran at the same time. Merge the two persons in Pipedrive. |
| **Connection needs attention** | Pipedrive stopped accepting the credentials. Select **Reconnect** and enter new credentials. |
| No data arrives | Check that the setting switch is on and that the product and currency filters do not skip the event. Check that the customer has an email address. |

## Disconnect and uninstall

Turn off the settings on the **Configure** tab to stop sending data. Uninstall the app to delete the Pipedrive connection. See [Manage and uninstall](https://docs.dodopayments.com/features/app-marketplace/manage-and-uninstall.md).


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