Open in Hubv5.0.0 The official Pipedrive integration allows your bot to create, update and search for Pipedrive contacts.

​
Setup

You will need:
1

Install the integration in Botpress

First, install the integration to your bot:
  1. In Botpress Studio, select Explore Hub in the upper-right corner.
  2. Search for the Pipedrive integration, then select Install Integration.
In the Configuration menu, you should see one field: API Key. Leave it empty for now—you’ll come back to it after creating your Pipedrive API key.
2

Create a Pipedrive API key

Next, create a Pipedrive API key:
  1. Log in to Pipedrive.
    The API key will inherit the permissions of whatever user you’re logging in as. Because of this, we recommend using a dedicated Pipedrive user account for the API key.This makes it easier to maintain the right permissions for the integration, or to rotate the key if it becomes compromised.
  2. Open the My Account menu in the upper-right corner, then select Personal preferences.
  3. Navigate to the API tab. You should see your personal API key—copy it.
If you don’t have an API key, select Generate new token.
3

Configure the integration in Botpress

Now, you can finish setting up the integration in Botpress:
  1. In the integration’s API Key field, paste your Pipedrive API key.
  2. Select Save Configuration.
Your Pipedrive integration is ready. You can use the integration’s Cards to interact with your Pipedrive contacts.

​
Cards

Here’s a reference for all Cards available with the integration:

​
Add Person

Input: Output:

​
Find Person

Input: Output:

​
Update Person

Input: Output:

​
Troubleshooting

If you run into errors when using the integration’s Cards, check out your bot’s Logs and locate the error message:
You can also consult Pipedrive’s error code reference for further troubleshooting.