Pipedrive

Read and write Pipedrive deals, deal products, persons, organizations, leads, activities, products and notes with custom fields, plus pipelines, stages, users and field definitions.

Keep the sales pipeline, contacts and products in step with marketing, quoting, finance and support systems.

Build a flow with Pipedrive Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

activities

Create activity
Destination
Not retried automatically
Creates a activity; custom fields are written by field key.
Get activity
Source
One activity with all custom fields.
List activities
Source
Incremental
Activities with custom fields, filtered by owner, saved filter or update time.
Update activity
Destination
Duplicate protected
Updates only the mapped activity fields.

deal products

Add product to deal
Destination
Not retried automatically
Attaches a product line to a deal.
List deal products
Source
Products attached to one deal with price, quantity, discount, tax and billing.
Update deal product
Destination
Duplicate protected
Updates price, quantity, discount, tax or billing of an attached product.

deals

Create deal
Destination
Not retried automatically
Creates a deal; custom fields are written by field key.
Get deal
Source
One deal with all custom fields.
List deals
Source
Incremental
Deals with custom fields, filtered by owner, saved filter or update time.
Search deals
Source
Full-text search over deals (minimum 2 characters, or 1 with exact match).
Update deal
Destination
Duplicate protected
Updates only the mapped deal fields.

fields

List fields
Source
Deal, person, organization or product field definitions with type and options, including custom fields (lead custom fields use deal fields).

leads

Create lead
Destination
Not retried automatically
Creates a lead linked to a person or organization.
Get lead
Source
One lead with custom fields.
List leads
Source
Incremental
Leads (non-archived by default) with value, labels and custom fields.
Search leads
Source
Searches lead titles, notes and custom fields.
Update lead
Destination
Duplicate protected
Updates mapped lead fields and custom fields.

notes

Create note
Destination
Not retried automatically
Adds an HTML note to a deal, lead, person, organization or project.
Get note
Source
One note.
List notes
Source
Incremental
Notes on deals, leads, persons, organizations or projects.
Update note
Destination
Duplicate protected
Updates note content, links or pins.

organizations

Create organization
Destination
Not retried automatically
Creates a organization; custom fields are written by field key.
Get organization
Source
One organization with all custom fields.
List organizations
Source
Incremental
Organizations with custom fields, filtered by owner, saved filter or update time.
Search organizations
Source
Full-text search over organizations (minimum 2 characters, or 1 with exact match).
Update organization
Destination
Duplicate protected
Updates only the mapped organization fields.

persons

Create person
Destination
Not retried automatically
Creates a person; custom fields are written by field key.
Get person
Source
One person with all custom fields.
List persons
Source
Incremental
Persons with custom fields, filtered by owner, saved filter or update time.
Search persons
Source
Full-text search over persons (minimum 2 characters, or 1 with exact match).
Update person
Destination
Duplicate protected
Updates only the mapped person fields.

pipelines

List pipelines
Source
Sales pipelines.

products

Create product
Destination
Not retried automatically
Creates a product; custom fields are written by field key.
Get product
Source
One product with all custom fields.
List products
Source
Incremental
Products with custom fields, filtered by owner, saved filter or update time.
Search products
Source
Full-text search over products (minimum 2 characters, or 1 with exact match).
Update product
Destination
Duplicate protected
Updates only the mapped product fields.

stages

List stages
Source
Pipeline stages with probability and rotting settings.

users

List users
Source
Company users with role, admin flag and activity status.

Authentication

Personal API token sent in the x-api-token header

Plans and access

All Pipedrive plans include the API; products and billing fields depend on the plan. The API token acts as the user who owns it and follows that user's visibility and permission sets.

Test environment

Pipedrive offers free developer sandbox accounts through the Developer Hub.

Rate limits

Token-based daily budget per company plan plus burst limits per 2-second window; HTTP 429 with Retry-After when exceeded.

Provider events

Webhooks v2 for create, change and delete events on deals, persons, organizations, activities and more. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

Uses API v2 where Pipedrive offers it (deals, persons, organizations, activities, products, deal products, pipelines, stages, fields, search) and v1 for leads, notes and users.
The API token is never sent in the api_token query parameter.
Custom field values are keyed by Pipedrive's 40-character field key; fetch definitions and option IDs with List fields.
Person marketing_status (Campaigns consent) is returned read-only and changes only when the Marketing status input is explicitly mapped.
Pipedrive has no idempotency key; uncertain creates are not repeated automatically.
Deletes, merges and follower changes are not automated.