Pipedrive

Pipedrive node reference - all 141 operations, the credential it needs, and a worked example.

Pipedrive integration (CRM). 141 operations: deals, deal followers, participants and line items; persons, organizations and their followers, files and change history; activities and activity types; leads and lead conversion; notes and note comments; products and variations; pipelines, stages and pipeline statistics; item search; custom-field metadata and filters; files; projects and tasks; users, currencies and recents; call logs; webhooks.

Credential: Pipedrive credential - see Credentials.

Scopes

Each operation below lists the scope it needs. Scopes are held by the Pipedrive USER whose API token the credential carries. Pipedrive does have real per-endpoint scopes - every operation in its OpenAPI specs names the ones that satisfy it, and the table below is read straight off those security blocks - but an API token is not scoped: it inherits that user's whole permission set. So these values are what an OAuth app would have to request, and what a 403 is really complaining about. For a token, a refusal means the underlying user lacks the permission, or (on the admin rows - webhooks, and the pipeline and stage writes this node does not implement) is not an admin. Values joined by or are alternatives, not a required set: any ONE of them is enough. Two results surprise people: the flow and changelog reads are gated by recents:read rather than by the resource's own scope, so deals:read does NOT authorise a deal's changelog; and base is granted to every token, so the current-user and currency reads always work. If a run fails with a permission error, the node names the missing scope in the error - grant it and re-run; you do not need to rebuild the workflow.

Operations (141)

Deals

Operation	What it does	Scope
`createDeal`	Create deal	`deals:full`
`updateDeal`	Update deal	`deals:full`
`getDeal`	Get deal	`deals:read or deals:full`
`listDeals`	List deals	`deals:read or deals:full`
`listArchivedDeals`	List archived deals	`deals:read or deals:full`
`searchDeals`	Search deals	`deals:read or deals:full or search:read`
`deleteDeal`	Delete deal	`deals:full`
`duplicateDeal`	Duplicate deal	`deals:full`
`mergeDeals`	Merge deal into another	`deals:full`
`convertDealToLead`	Convert deal to lead	`deals:full`
`getDealConversionStatus`	Get deal conversion status	`deals:full or deals:read`
`getDealsSummary`	Get deals summary	`deals:read or deals:full`
`getDealsTimeline`	Get deals timeline	`deals:read or deals:full`
`getDealFlow`	Get deal updates (flow)	`recents:read`
`getDealChangelog`	Get deal changelog	`recents:read`
`listDealFiles`	List files on a deal	`deals:read or deals:full`

Deal followers & participants

Operation	What it does	Scope
`listDealFollowers`	List deal followers	`deals:read or deals:full`
`addDealFollower`	Add deal follower	`deals:full`
`removeDealFollower`	Remove deal follower	`deals:full`
`listDealParticipants`	List deal participants	`deals:read or deals:full`
`addDealParticipant`	Add deal participant	`deals:full`
`removeDealParticipant`	Remove deal participant	`deals:full`

Deal products (line items)

Operation	What it does	Scope
`listDealProducts`	List products on a deal	`products:read or products:full or deals:read or deals:full`
`addDealProduct`	Add product to deal	`products:full or deals:full`
`updateDealProduct`	Update deal product	`products:full or deals:full`
`deleteDealProduct`	Remove product from deal	`deals:full or products:full`
`listAllDealProducts`	List deal products across deals	`products:read or products:full or deals:read or deals:full`

Persons

Operation	What it does	Scope
`createPerson`	Create person	`contacts:full`
`updatePerson`	Update person	`contacts:full`
`getPerson`	Get person	`contacts:read or contacts:full`
`listPersons`	List persons	`contacts:read or contacts:full`
`searchPersons`	Search persons	`contacts:read or contacts:full or search:read`
`deletePerson`	Delete person	`contacts:full`
`mergePersons`	Merge person into another	`contacts:full`
`listPersonFollowers`	List person followers	`contacts:read or contacts:full`
`addPersonFollower`	Add person follower	`contacts:full`
`removePersonFollower`	Remove person follower	`contacts:full`
`getPersonChangelog`	Get person changelog	`recents:read`
`getPersonFlow`	Get person updates (flow)	`recents:read`
`listPersonFiles`	List files on a person	`contacts:read or contacts:full`
`listPersonProducts`	List products linked to a person	`contacts:read or contacts:full`

Organizations

Operation	What it does	Scope
`createOrganization`	Create organization	`contacts:full`
`updateOrganization`	Update organization	`contacts:full`
`getOrganization`	Get organization	`contacts:read or contacts:full`
`listOrganizations`	List organizations	`contacts:read or contacts:full`
`searchOrganizations`	Search organizations	`contacts:read or contacts:full or search:read`
`deleteOrganization`	Delete organization	`contacts:full`
`mergeOrganizations`	Merge organization into another	`contacts:full`
`listOrganizationFollowers`	List organization followers	`contacts:read or contacts:full`
`addOrganizationFollower`	Add organization follower	`contacts:full`
`removeOrganizationFollower`	Remove organization follower	`contacts:full`
`getOrganizationChangelog`	Get organization changelog	`recents:read`
`getOrganizationFlow`	Get organization updates (flow)	`recents:read`
`listOrganizationFiles`	List files on an organization	`contacts:read or contacts:full`
`listOrganizationRelationships`	List organization relationships	`contacts:read or contacts:full`
`createOrganizationRelationship`	Create organization relationship	`contacts:full`
`deleteOrganizationRelationship`	Delete organization relationship	`contacts:full`

Activities

Operation	What it does	Scope
`createActivity`	Create activity	`activities:full`
`updateActivity`	Update / complete activity	`activities:full`
`getActivity`	Get activity	`activities:read or activities:full`
`listActivities`	List activities	`activities:read or activities:full`
`deleteActivity`	Delete activity	`activities:full`
`listActivityTypes`	List activity types	`activities:read or activities:full or admin`

Leads

Operation	What it does	Scope
`createLead`	Create lead	`leads:full`
`updateLead`	Update lead	`leads:full`
`getLead`	Get lead	`leads:read or leads:full`
`listLeads`	List leads	`leads:read or leads:full`
`listArchivedLeads`	List archived leads	`leads:read or leads:full`
`deleteLead`	Delete lead	`leads:full`
`searchLeads`	Search leads	`leads:read or leads:full or search:read`
`convertLeadToDeal`	Convert lead to deal	`leads:full`
`getLeadConversionStatus`	Get lead conversion status	`leads:full or leads:read`
`listLeadLabels`	List lead labels	`leads:read or leads:full`
`listLeadSources`	List lead sources	`leads:read or leads:full`

Notes & comments

Operation	What it does	Scope
`createNote`	Create note	`deals:full or contacts:full`
`updateNote`	Update note	`deals:full or contacts:full`
`getNote`	Get note	`deals:read or deals:full or contacts:read or contacts:full`
`listNotes`	List notes	`deals:read or deals:full or contacts:read or contacts:full`
`deleteNote`	Delete note	`deals:full or contacts:full`
`listNoteComments`	List note comments	`deals:read or deals:full or contacts:read or contacts:full`
`createNoteComment`	Comment on a note	`deals:full or contacts:full`
`updateNoteComment`	Update note comment	`deals:full or contacts:full`
`deleteNoteComment`	Delete note comment	`deals:full or contacts:full`

Products

Operation	What it does	Scope
`createProduct`	Create product	`products:full`
`updateProduct`	Update product	`products:full`
`getProduct`	Get product	`products:read or products:full`
`listProducts`	List products	`products:read or products:full`
`searchProducts`	Search products	`products:read or products:full or search:read`
`deleteProduct`	Delete product	`products:full`
`duplicateProduct`	Duplicate product	`products:full`
`listProductVariations`	List product variations	`products:read or products:full`
`createProductVariation`	Create product variation	`products:full`
`listProductDeals`	List deals with a product	`deals:read or deals:full`
`listProductFollowers`	List product followers	`products:read or products:full`
`addProductFollower`	Add product follower	`products:full`

Pipelines & stages

Operation	What it does	Scope
`listPipelines`	List pipelines	`deals:read or deals:full or admin`
`getPipeline`	Get pipeline	`deals:read or deals:full or admin`
`listStages`	List stages	`deals:read or deals:full or admin`
`getStage`	Get stage	`deals:read or deals:full or admin`
`listPipelineDeals`	List deals in a pipeline	`deals:read or deals:full`
`listStageDeals`	List deals in a stage	`deals:read or deals:full`
`getPipelineConversionStats`	Get pipeline conversion statistics	`deals:read or deals:full`
`getPipelineMovementStats`	Get pipeline movement statistics	`deals:read or deals:full`

Search

Operation	What it does	Scope
`itemSearch`	Search across all item types	`search:read`
`itemSearchByField`	Search values of one field	`search:read`

Custom fields & filters

Operation	What it does	Scope
`listDealFields`	List deal fields	`deals:read or deals:full or admin or deal-fields:full`
`listPersonFields`	List person fields	`contacts:read or contacts:full or admin or contact-fields:full`
`listOrganizationFields`	List organization fields	`contacts:read or contacts:full or admin or contact-fields:full`
`listProductFields`	List product fields	`products:read or products:full or product-fields:full`
`listActivityFields`	List activity fields	`activities:read or activities:full`
`listLeadFields`	List lead fields	`leads:read or leads:full or admin`
`listFilters`	List filters	`deals:read or deals:full or activities:read or activities:full or contacts:read or contacts:full`
`getFilter`	Get filter	`deals:read or deals:full or activities:read or activities:full or contacts:read or contacts:full`

Files

Operation	What it does	Scope
`listFiles`	List files	`deals:read or deals:full or activities:read or activities:full or contacts:read or contacts:full`
`getFile`	Get file metadata	`deals:read or deals:full or activities:read or activities:full or contacts:read or contacts:full`
`deleteFile`	Delete file	`deals:full or activities:full or contacts:full`

Projects & tasks

Operation	What it does	Scope
`listProjects`	List projects	`projects:read or projects:full`
`getProject`	Get project	`projects:read or projects:full`
`createProject`	Create project	`projects:full`
`updateProject`	Update project	`projects:full`
`archiveProject`	Archive project	`projects:full`
`searchProjects`	Search projects	`projects:read or projects:full or search:read`
`listTasks`	List tasks	`projects:read or projects:full`
`getTask`	Get task	`projects:read or projects:full`
`createTask`	Create task	`projects:full`
`updateTask`	Update task	`projects:full`
`deleteTask`	Delete task	`projects:full`
`listProjectTasks`	List tasks in a project	`projects:read or projects:full`
`listProjectActivities`	List activities in a project	`projects:read or projects:full`

Users & account

Operation	What it does	Scope
`listUsers`	List users	`users:read`
`getUser`	Get user	`users:read`
`findUsers`	Find users by name or email	`users:read`
`getCurrentUser`	Get the authorized user	`base`
`listCurrencies`	List currencies	`base`
`getRecents`	Get recent changes	`recents:read or search:read`

Call logs

Operation	What it does	Scope
`listCallLogs`	List call logs	`phone-integration`
`getCallLog`	Get call log	`phone-integration`
`createCallLog`	Create call log	`phone-integration`

Webhooks

Operation	What it does	Scope
`listWebhooks`	List webhooks	`admin`
`createWebhook`	Create webhook	`admin`
`deleteWebhook`	Delete webhook	`admin`

Example

Create a person with an email and phone that actually stick

This is the operation most affected by Pipedrive's v1-to-v2 rewrite. In v1 a person's contact details were the scalars email and phone; in v2 they are arrays of {value, primary, label}, and the v1 endpoint that accepted the old shape has been REMOVED from the published spec. The dialog still shows one email box — the executor sends v2's array shape underneath. That is a fix, not a regression: the old shape has no endpoint left to accept it.

Set Operation to createPerson, then fill in:

Field	Value	Notes
`name`	`{{ myTrigger.fullName }}`	Pipedrive's required field for a person
`email`	`{{ myTrigger.email }}`	Sent as v2's `emails: [{value, primary: true}]` array shape
`phone`	`{{ myTrigger.phone }}`	Sent as v2's `phones: [{value, primary: true}]` array shape
`orgId`	`{{ org.id }}`	Optional; links the person to an organization

Sets {{person.id}} and {{person.person}} — the original result shape, pinned so workflows saved before the v2 migration keep resolving.

On this page