knoten / builtin / integration
Pipedrive
Log the person or organization you're viewing to Pipedrive CRM — create or update records and attach the page as a note.
Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.
Turn the profile or company page you are viewing into a Pipedrive contact, and log the page as a note on it.
What it does
Section titled “What it does”The Pipedrive node works on three kinds of things (Resource):
- Person: create or update a contact, or search contacts.
- Organization: create or update a company, or search companies.
- Note: add a note, linked to a person, an organization, or both.
Create or update never makes a duplicate on purpose. It first looks for an exact match: by Email for a person, by Name for an organization. If it finds one, it updates that record; if not, it creates a new one. The result tells you which happened (created: true or false). Fields you leave empty are not sent, so an update never wipes a value you did not fill.
Note → Create builds the note from Note, then the Selection in quotes, then a Source: line with the Source URL.
Search returns 10 matches unless you set Limit.
When to use it
Section titled “When to use it”- Log the LinkedIn-style profile you are viewing as a person, with the page attached as a note.
- Add a company you found on the web as an organization, with its address.
- Check whether someone is already in your CRM before reaching out.
- Keep a trail of the pages and quotes that led to a deal.
For HubSpot or Attio, use HubSpot or Attio.
Inputs and settings
Section titled “Inputs and settings”| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Credential (erforderlich) | Credential | A Pipedrive API token (Settings → Personal preferences → API). It is account-wide — it acts with your full user access. Keep it secret. |
5 Auswahlmöglichkeiten · wählen Sie Resource and Operation, um die Einstellungen zu sehen
Einstellungen für Person · Create or update
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Email (erforderlich) | Text | The person’s email — the unique key used to find an existing person. |
| Name | Text | |
| Phone | Text |
Einstellungen für Person · Search
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Query (erforderlich) | Text | Search term matched across the record’s fields. |
| Limit | Number | Maximum number of results. |
Einstellungen für Organization · Create or update
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Name (erforderlich) | Text | The organization name — the unique key used to find an existing organization. |
| Address | Text |
Einstellungen für Organization · Search
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Query (erforderlich) | Text | Search term matched across the record’s fields. |
| Limit | Number | Maximum number of results. |
Einstellungen für Note · Create
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Note (erforderlich) | Text | The note text. |
| Source URL | Text | The page URL to attach — appended to the note when present. |
| Selection | Text | Selected text to quote in the note (optional). |
| Person ID | Number | Attach the note to this person (optional). |
| Organization ID | Number | Attach the note to this organization (optional). |
Einstellungen für Person · Create or update werden angezeigt
- When a person is new, fill Name as well: Pipedrive needs a name to create a person.
- On an update, Phone replaces the person’s phone list with the one number you give.
- Person ID and Organization ID are numbers. Take them from the
idof a Create or update result, for example{{ $('Pipedrive').id }}, or fromitems[0].item.idof a Search. - Link each note to at least one record (Person ID or Organization ID); Pipedrive refuses notes that are linked to nothing.
Outputs
Section titled “Outputs”-
Output
- Create or update returns the person or organization as Pipedrive stores it, including its
idandname, pluscreated(truefor a new record,falsefor an update). - Search returns one item with an
itemslist. Each entry has aresult_scoreand the matching record underitem(with itsidandname). - Note → Create returns the new note, including its
idandcontent.
Dependencies and credentials
Section titled “Dependencies and credentials”- Credential (connection, Bearer Token): required. See Connect Pipedrive.
Use your Pipedrive API token, saved as a Bearer Token credential. In Pipedrive, open Settings → Personal preferences → API and copy the token. See Create a credential.
The token is account-wide: it can do anything your Pipedrive user can, and it has no per-record limits. Keep it like a password.
Example workflow
Section titled “Example workflow”- A Context Menu trigger with Menu Contexts
Selection: highlight the contact details on a profile page and pick “Save to Pipedrive”. It passes onselectionTextandpageUrl. - Information Extractor with Text
{{ $input.selectionText }}, an OpenAI model and a Structured Output Parser whose JSON Output Example is{ "name": "Jane Doe", "email": "jane@example.com", "phone": "+33 6 12 34 56 78" }. - Pipedrive, Person → Create or update, Email
{{ $input.extracted.email }}, Name{{ $input.extracted.name }}, Phone{{ $input.extracted.phone }}. - Pipedrive, Note → Create, Note
Found while browsing, Person ID{{ $input.id }}, Source URL{{ $('Context Menu').pageUrl }}.
Common issues
Section titled “Common issues”- “Pipedrive API Error: 401 … the API token is missing or invalid”. Copy the token again from Settings → Personal preferences → API and update the credential. A regenerated token makes the old one stop working.
- “Pipedrive API Error: …” when creating a person. Often the Name is empty for a new person. Fill it.
- A duplicate record appeared. Two runs created the same email or name a moment apart, before Pipedrive’s search caught up. Run them one after another, or search first.
- The run is blocked in the web app. Pipedrive runs through the browser extension. Install the extension and allow Pipedrive for this workflow when asked, or run the workflow from the extension. See Running extension-only integrations in the web app.
Related nodes
Section titled “Related nodes”- Information Extractor: pull name, email and company out of a page.
- HubSpot and Attio: other CRMs.
- Http Request: deals, activities and other Pipedrive objects this node does not cover.