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

# Connect your app to Pipedrive

> Connect your app to Pipedrive, a sales CRM, to manage deals, contacts, activities, leads, and sales pipeline data from your Lovable app.

export const connector_0 = "Pipedrive"

[Pipedrive](https://www.pipedrive.com/) is a sales CRM for managing deals, contacts, activities, leads, and pipelines. The Pipedrive connector lets your Lovable app read and manage CRM data through the Pipedrive API. It's designed for sales dashboards, customer portals, workflow automation, and internal tools that need access to Pipedrive records.

Pipedrive is available as an [app + chat connector](/integrations/app-connectors): one shared connection that works in the chat while you build and in your published apps.

With Pipedrive, your app can:

* Create, update, and list deals across sales pipelines
* Manage people, organizations, leads, and activities
* Read pipeline, stage, field, and user metadata for CRM workflows
* Build dashboards and automations around Pipedrive CRM data
* Register webhooks when your app needs to react to Pipedrive changes

Pipedrive is a good fit when your team manages sales activity in Pipedrive and wants a custom Lovable app for reporting, operations, customer handoffs, or sales workflows.

## Common use cases and example apps

| Example app                      | Example prompt                                                                                                                 | Description                                                                                                                                                                   |
| :------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sales pipeline dashboard**     | *Use Pipedrive and build a dashboard that shows open deals by stage, owner, and expected close date.*                          | **Track pipeline health from live CRM data.**<br />The app reads deals, stages, and users from Pipedrive so sales managers can review pipeline movement in one place.         |
| **Account handoff tracker**      | *Use Pipedrive and build a handoff tracker for won deals that shows the customer, deal value, notes, and next activity.*       | **Turn closed-won deals into operational handoffs.**<br />The app pulls deal, person, organization, and activity data so customer-facing teams can pick up the right context. |
| **Lead intake queue**            | *Use Pipedrive and build a lead intake queue where new leads can be reviewed, assigned, and moved into the right pipeline.*    | **Manage lead qualification from a custom interface.**<br />The app lists leads and related contacts from Pipedrive, then updates records when a lead is ready for follow-up. |
| **Activity follow-up assistant** | *Use Pipedrive and build an app that lists overdue sales activities and lets reps mark them complete after follow-up.*         | **Keep sales teams focused on overdue work.**<br />The app reads activities by owner and due date, then updates Pipedrive after reps complete calls, emails, or meetings.     |
| **Customer lookup portal**       | *Use Pipedrive and build an internal portal where support can search people and organizations before responding to customers.* | **Give support teams quick CRM context.**<br />The app searches Pipedrive contacts and organizations so teams can see account details without switching tools.                |
| **Deal-change notifications**    | *Use Pipedrive and build a notification workflow that alerts the team when a high-value deal changes stage.*                   | **React to important CRM changes.**<br />The app uses Pipedrive webhooks or polling to detect deal updates and notify the right team members.                                 |

## How to connect Pipedrive

Who can create Pipedrive connections depends on your plan and workspace settings. App + chat connectors are available by default on Free, Pro, and Business plans. On Enterprise plans, they are effectively disabled at first: [Who can create connections and clients](/integrations/admin-controls#who-can-create-connections-and-clients) defaults to **No one** until an admin changes it in **Connectors → Admin settings → App + chat connectors**.

When adding a connection, you can choose between:

* **Connect with Pipedrive**: sign in with your Pipedrive account in one click (OAuth)
* **Use your own credentials**: bring your own Pipedrive API token

You can create multiple Pipedrive connections using different accounts or API tokens, which is useful for separating environments (for example, development and production), connecting different Pipedrive accounts, or managing access for different teams.

When the connection is created, you can [link it to the projects](/integrations/app-connectors#link-a-connection-to-a-project) where you want to use it. Anyone building in a project can ask Lovable in chat to link their project to it.

### Prerequisites

Before connecting Pipedrive, make sure you have:

* A Pipedrive account
* Permission to **create connections** in your Lovable workspace (see [Who can create connections and clients](/integrations/admin-controls#who-can-create-connections-and-clients))

<Note>
  All API requests made through this connector count toward your Pipedrive plan limits. Billing and quota are handled directly by Pipedrive, not Lovable.
</Note>

Follow the setup steps below based on how you want to connect Pipedrive.

<Tabs>
  <Tab title="Connect with your Pipedrive account">
    Choose this option for the fastest setup. You authorize Lovable's Pipedrive app with your Pipedrive account, and no API token is needed. In the connection form, this option is labeled **Connect with Pipedrive**.

    <Steps>
      <Step title="Open Pipedrive in Connectors">
        Open [**Connectors**](https://lovable.dev/dashboard?connectors) and select **Pipedrive**. For the other places to open the catalog from, see [Where to find connectors](/integrations/introduction#where-to-find-connectors).
      </Step>

      <Step title="Add a connection">
        Click **Add connection**.
      </Step>

      <Step title="Name the connection">
        In **Display name**, name the connection (for example, `Pipedrive Prod`). This name is only used inside Lovable to identify the connection.
      </Step>

      <Step title="Choose Pipedrive authentication">
        Under **Authentication**, select **Connect with Pipedrive**. This is the OAuth option.
      </Step>

      <Step title="Choose who can use this connection">
        Under **Who can use this connection**, decide who in your workspace can use the connection. You start as the only person with access:

        * **Only you** (default): leave the access list as is; only you can use the connection and its associated data.
        * **Invite specific people**: add workspace members by email; only you and the people you add can use the connection and its associated data.
        * **Invite entire workspace**: click **Invite entire workspace** to make the connection available to everyone in your Lovable workspace.

        See [Who can use connections and clients](/integrations/admin-controls#who-can-use-connections-and-clients) for more information.
      </Step>

      <Step title="Connect to Pipedrive and authorize">
        Click **Connect**. The Pipedrive authorization window opens, so make sure your browser doesn't block pop-ups. If it does, Lovable redirects you instead.

        Sign in to Pipedrive if prompted, review the requested permissions, and authorize the app.

        You'll be redirected back to Lovable with a confirmation. API calls are routed to your company's own Pipedrive domain automatically.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Use your own credentials">
    Bring your own API token if you want to control the exact Pipedrive user the connection acts as, or your Pipedrive setup does not allow installing Marketplace apps.

    ### Step 1: Get a Pipedrive API token

    A Pipedrive API token lets your Lovable app authenticate with the Pipedrive API as the Pipedrive user who owns the token.

    To find your Pipedrive API token:

    <Steps>
      <Step title="Open your Pipedrive account">
        Sign in to [Pipedrive](https://app.pipedrive.com/) with the account you want your Lovable app to use.
      </Step>

      <Step title="Open personal preferences">
        Open your profile menu and go to **Personal preferences**.
      </Step>

      <Step title="Open the API tab">
        Select the **API** tab. If you do not see an API tab, check that your Pipedrive plan and role allow API access.
      </Step>

      <Step title="Copy the token">
        Copy your API token and store it securely.
      </Step>
    </Steps>

    <Warning>
      Your API token functions like a password. Keep it secure and never share it publicly. You need it in the next step.
    </Warning>

    See Pipedrive documentation for more: [How to find the API token](https://pipedrive.readme.io/docs/how-to-find-the-api-token).

    ### Step 2: Connect Pipedrive to Lovable

    With your API token ready, add the connection in Lovable. You can create multiple connections using different API tokens.

    <Steps>
      <Step title="Open Pipedrive in Connectors">
        Open [**Connectors**](https://lovable.dev/dashboard?connectors) and select **Pipedrive**. For the other places to open the catalog from, see [Where to find connectors](/integrations/introduction#where-to-find-connectors).
      </Step>

      <Step title="Add a connection">
        Click **Add connection**.
      </Step>

      <Step title="Name the connection">
        In **Display name**, name the connection (for example, `Pipedrive Prod`). This name is only used inside Lovable to identify the connection.
      </Step>

      <Step title="Choose your own credentials">
        Under **Authentication**, select **Use your own credentials**. Then paste your Pipedrive API token in **API token**.
      </Step>

      <Step title="Choose who can use this connection">
        Under **Who can use this connection**, decide who in your workspace can use the connection. You start as the only person with access:

        * **Only you** (default): leave the access list as is; only you can use the connection and its associated data.
        * **Invite specific people**: add workspace members by email; only you and the people you add can use the connection and its associated data.
        * **Invite entire workspace**: click **Invite entire workspace** to make the connection available to everyone in your Lovable workspace.

        See [Who can use connections and clients](/integrations/admin-controls#who-can-use-connections-and-clients) for more information.
      </Step>

      <Step title="Connect">
        Click **Connect**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

When connected, anyone building in a project can ask Lovable in chat to link their project to Pipedrive (based on configured connection-level access). Your Lovable apps can then read and manage Pipedrive CRM data.

## Working with Pipedrive data and webhooks

Each connection represents one Pipedrive user, whether it connects with OAuth or an API token, and API calls use that user's Pipedrive permissions.

If your app needs to react to CRM changes, ask Lovable to set up Pipedrive webhooks for the events you care about, such as deal creation, deal stage changes, or lead updates. Pipedrive sends webhook events to a public endpoint in your app. For critical workflows, combine webhooks with periodic API checks because webhook deliveries are not guaranteed by Pipedrive.

When prompting Lovable, be specific about the records and operations your app needs. For example, mention whether the app should work with deals, leads, people, organizations, activities, pipelines, or stages.

## Limitations

The Pipedrive connector cannot:

* Create a Pipedrive account for you
* Manage Pipedrive billing, plans, roles, or API access settings
* Support per-end-user Pipedrive login. Each connection represents a single Pipedrive user account shared across projects linked to it.
* Rotate API tokens automatically. For connections that use your own API token, generate the new token in Pipedrive and update the Lovable connection. OAuth connections refresh their credentials automatically.
* Create a webhook receiver automatically without app code. Ask Lovable to build the public endpoint and register the webhook for the events your app needs.

If Pipedrive authorization is revoked from the Pipedrive side, you'll need to reconnect the integration in Lovable before API calls can succeed again.

## Manage your {connector_0} connection

Connections are managed from [**Connectors**](https://lovable.dev/dashboard?connectors): select **{connector_0}**, then open the connection.

* **Unlink projects** to remove {connector_0} access from specific projects while keeping the connection available for others. See [Unlink projects from a connection](/integrations/app-connectors#unlink-projects-from-a-connection) for the steps.
* **Delete the connection** to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use {connector_0} stop working until a new connection is added. See [Delete a connection](/integrations/app-connectors#delete-a-connection) for the steps and who can delete.