Pipedrive

Interact with Pipedrive CRM

Usage Instructions

Integrate Pipedrive into your workflow. Manage deals, contacts, sales pipeline, projects, activities, files, and communications with powerful CRM capabilities.

Tools

`pipedrive_get_all_deals`

Input

Parameter	Type	Required	Description
`status`	string	No	Only fetch deals with a specific status. Values: open, won, lost. If omitted, all not deleted deals are returned
`person_id`	string	No	If supplied, only deals linked to the specified person are returned (e.g., "456")
`org_id`	string	No	If supplied, only deals linked to the specified organization are returned (e.g., "789")
`pipeline_id`	string	No	If supplied, only deals in the specified pipeline are returned (e.g., "1")
`updated_since`	string	No	If set, only deals updated after this time are returned. Format: 2025-01-01T10:20:00Z
`limit`	string	No	Number of results to return (e.g., "50", default: 100, max: 500)
`cursor`	string	No	No description

Output

Parameter	Type	Description
`deals`	array	Array of deal objects from Pipedrive
↳ `id`	number	Deal ID
↳ `title`	string	Deal title
↳ `value`	number	Deal value
↳ `currency`	string	Currency code
↳ `status`	string	Deal status (open, won, lost, deleted)
↳ `stage_id`	number	Pipeline stage ID
↳ `pipeline_id`	number	Pipeline ID
↳ `person_id`	number	Associated person ID
↳ `org_id`	number	Associated organization ID
↳ `owner_id`	number	Deal owner user ID
↳ `add_time`	string	When the deal was created (ISO 8601)
↳ `update_time`	string	When the deal was last updated (ISO 8601)
↳ `won_time`	string	When the deal was won
↳ `lost_time`	string	When the deal was lost
↳ `close_time`	string	When the deal was closed
↳ `expected_close_date`	string	Expected close date
`metadata`	object	Pagination metadata for the response
↳ `total_items`	number	Total number of items
↳ `has_more`	boolean	Whether more items are available
↳ `next_cursor`	string	Cursor for fetching the next page (v2 endpoints)
↳ `next_start`	number	Offset for fetching the next page (v1 endpoints)
`success`	boolean	Operation success status

`pipedrive_get_deal`

Input

Parameter	Type	Required	Description
`deal_id`	string	Yes	The ID of the deal to retrieve (e.g., "123")

Output

Parameter	Type	Description
`deal`	object	Deal object with full details
`success`	boolean	Operation success status

`pipedrive_create_deal`

Input

Parameter	Type	Required	Description
`title`	string	Yes	The title of the deal (e.g., "Enterprise Software License")
`value`	string	No	The monetary value of the deal (e.g., "5000")
`currency`	string	No	Currency code (e.g., "USD", "EUR", "GBP")
`person_id`	string	No	ID of the person this deal is associated with (e.g., "456")
`org_id`	string	No	ID of the organization this deal is associated with (e.g., "789")
`pipeline_id`	string	No	ID of the pipeline this deal should be placed in (e.g., "1")
`stage_id`	string	No	ID of the stage this deal should be placed in (e.g., "2")
`status`	string	No	No description
`expected_close_date`	string	No	Expected close date in YYYY-MM-DD format (e.g., "2025-06-30")

Output

Parameter	Type	Description
`deal`	object	The created deal object
`success`	boolean	Operation success status

`pipedrive_update_deal`

Input

Parameter	Type	Required	Description
`deal_id`	string	Yes	The ID of the deal to update (e.g., "123")
`title`	string	No	New title for the deal (e.g., "Updated Enterprise License")
`value`	string	No	New monetary value for the deal (e.g., "7500")
`status`	string	No	No description
`stage_id`	string	No	New stage ID for the deal (e.g., "3")
`expected_close_date`	string	No	New expected close date in YYYY-MM-DD format (e.g., "2025-07-15")

Output

Parameter	Type	Description
`deal`	object	The updated deal object
`success`	boolean	Operation success status

`pipedrive_get_files`

Input

Parameter	Type	Required	Description
`sort`	string	No	Sort files by field (supported: "id", "update_time")
`limit`	string	No	Number of results to return (e.g., "50", default: 100, max: 100)
`start`	string	No	No description
`downloadFiles`	boolean	No	No description

Output

Parameter	Type	Description
`files`	array	Array of file objects from Pipedrive
↳ `id`	number	File ID
↳ `name`	string	File name
↳ `file_type`	string	File type/extension
↳ `file_size`	number	File size in bytes
↳ `add_time`	string	When the file was uploaded
↳ `update_time`	string	When the file was last updated
↳ `deal_id`	number	Associated deal ID
↳ `person_id`	number	Associated person ID
↳ `org_id`	number	Associated organization ID
↳ `url`	string	File download URL
`downloadedFiles`	file[]	Downloaded files from Pipedrive
`total_items`	number	Total number of files returned
`has_more`	boolean	Whether more files are available
`next_start`	number	Offset for fetching the next page
`success`	boolean	Operation success status

`pipedrive_get_mail_messages`

Input

Parameter	Type	Required	Description
`folder`	string	No	No description
`limit`	string	No	Number of results to return (e.g., "25", default: 50)
`start`	string	No	No description

Output

Parameter	Type	Description
`messages`	array	Array of mail thread objects from Pipedrive mailbox
`total_items`	number	Total number of mail threads returned
`has_more`	boolean	Whether more messages are available
`next_start`	number	Offset for fetching the next page
`success`	boolean	Operation success status

`pipedrive_get_mail_thread`

Input

Parameter	Type	Required	Description
`thread_id`	string	Yes	The ID of the mail thread (e.g., "12345")

Output

Parameter	Type	Description
`messages`	array	Array of mail message objects from the thread
`metadata`	object	Thread and pagination metadata
`success`	boolean	Operation success status

`pipedrive_get_pipelines`

Input

Parameter	Type	Required	Description
`sort_by`	string	No	No description
`sort_direction`	string	No	No description
`limit`	string	No	Number of results to return (e.g., "50", default: 100, max: 500)
`start`	string	No	No description

Output

Parameter	Type	Description
`pipelines`	array	Array of pipeline objects from Pipedrive
↳ `id`	number	Pipeline ID
↳ `name`	string	Pipeline name
↳ `url_title`	string	URL-friendly title
↳ `order_nr`	number	Pipeline order number
↳ `active`	boolean	Whether the pipeline is active
↳ `deal_probability`	boolean	Whether deal probability is enabled
↳ `add_time`	string	When the pipeline was created
↳ `update_time`	string	When the pipeline was last updated
`total_items`	number	Total number of pipelines returned
`has_more`	boolean	Whether more pipelines are available
`next_start`	number	Offset for fetching the next page
`success`	boolean	Operation success status

`pipedrive_get_pipeline_deals`

Input

Parameter	Type	Required	Description
`pipeline_id`	string	Yes	The ID of the pipeline (e.g., "1")
`stage_id`	string	No	Filter by specific stage within the pipeline (e.g., "2")
`limit`	string	No	Number of results to return (e.g., "50", default: 100, max: 500)
`start`	string	No	No description

Output

Parameter	Type	Description
`deals`	array	Array of deal objects from the pipeline
`metadata`	object	Pipeline and pagination metadata
`success`	boolean	Operation success status

`pipedrive_get_projects`

Input

Parameter	Type	Required	Description
`project_id`	string	No	Optional: ID of a specific project to retrieve (e.g., "123")
`status`	string	No	No description
`limit`	string	No	Number of results to return (e.g., "50", default: 100, max: 500, only for listing all)
`cursor`	string	No	No description

Output

Parameter	Type	Description
`projects`	array	Array of project objects (when listing all)
`project`	object	Single project object (when project_id is provided)
`total_items`	number	Total number of projects returned
`has_more`	boolean	Whether more projects are available
`next_cursor`	string	Cursor for fetching the next page
`success`	boolean	Operation success status

`pipedrive_create_project`

Input

Parameter	Type	Required	Description
`title`	string	Yes	The title of the project (e.g., "Q2 Marketing Campaign")
`description`	string	No	No description
`start_date`	string	No	Project start date in YYYY-MM-DD format (e.g., "2025-04-01")
`end_date`	string	No	Project end date in YYYY-MM-DD format (e.g., "2025-06-30")

Output

Parameter	Type	Description
`project`	object	The created project object
`success`	boolean	Operation success status

`pipedrive_get_activities`

Input

Parameter	Type	Required	Description
`user_id`	string	No	Filter activities by user ID (e.g., "123")
`type`	string	No	No description
`done`	string	No	No description
`limit`	string	No	Number of results to return (e.g., "50", default: 100, max: 500)
`start`	string	No	No description

Output

Parameter	Type	Description
`activities`	array	Array of activity objects from Pipedrive
↳ `id`	number	Activity ID
↳ `subject`	string	Activity subject
↳ `type`	string	Activity type (call, meeting, task, etc.)
↳ `due_date`	string	Due date (YYYY-MM-DD)
↳ `due_time`	string	Due time (HH:MM)
↳ `duration`	string	Duration (HH:MM)
↳ `deal_id`	number	Associated deal ID
↳ `person_id`	number	Associated person ID
↳ `org_id`	number	Associated organization ID
↳ `done`	boolean	Whether the activity is done
↳ `note`	string	Activity note
↳ `add_time`	string	When the activity was created
↳ `update_time`	string	When the activity was last updated
`total_items`	number	Total number of activities returned
`has_more`	boolean	Whether more activities are available
`next_start`	number	Offset for fetching the next page
`success`	boolean	Operation success status

`pipedrive_create_activity`

Input

Parameter	Type	Required	Description
`subject`	string	Yes	The subject/title of the activity (e.g., "Follow up call with John")
`type`	string	Yes	No description
`due_date`	string	Yes	Due date in YYYY-MM-DD format (e.g., "2025-03-15")
`due_time`	string	No	Due time in HH:MM format (e.g., "14:30")
`duration`	string	No	Duration in HH:MM format (e.g., "01:00" for 1 hour)
`deal_id`	string	No	ID of the deal to associate with (e.g., "123")
`person_id`	string	No	ID of the person to associate with (e.g., "456")
`org_id`	string	No	ID of the organization to associate with (e.g., "789")
`note`	string	No	No description

Output

Parameter	Type	Description
`activity`	object	The created activity object
`success`	boolean	Operation success status

`pipedrive_update_activity`

Input

Parameter	Type	Required	Description
`activity_id`	string	Yes	The ID of the activity to update (e.g., "12345")
`subject`	string	No	New subject/title for the activity (e.g., "Updated meeting with client")
`due_date`	string	No	New due date in YYYY-MM-DD format (e.g., "2025-03-20")
`due_time`	string	No	New due time in HH:MM format (e.g., "15:00")
`duration`	string	No	New duration in HH:MM format (e.g., "00:30" for 30 minutes)
`done`	string	No	No description
`note`	string	No	No description

Output

Parameter	Type	Description
`activity`	object	The updated activity object
`success`	boolean	Operation success status

`pipedrive_get_leads`

Input

Parameter	Type	Required	Description
`lead_id`	string	No	Optional: ID of a specific lead to retrieve (e.g., "abc123-def456-ghi789")
`archived`	string	No	Get archived leads instead of active ones (e.g., "true" or "false")
`owner_id`	string	No	Filter by owner user ID (e.g., "123")
`person_id`	string	No	Filter by person ID (e.g., "456")
`organization_id`	string	No	Filter by organization ID (e.g., "789")
`limit`	string	No	Number of results to return (e.g., "50", default: 100, max: 500)
`start`	string	No	No description

Output

Parameter	Type	Description
`leads`	array	Array of lead objects (when listing all)
↳ `id`	string	Lead ID (UUID)
↳ `title`	string	Lead title
↳ `person_id`	number	ID of the associated person
↳ `organization_id`	number	ID of the associated organization
↳ `owner_id`	number	ID of the lead owner
↳ `value`	object	Lead value
↳ `amount`	number	Value amount
↳ `currency`	string	Currency code (e.g., USD, EUR)
↳ `expected_close_date`	string	Expected close date (YYYY-MM-DD)
↳ `is_archived`	boolean	Whether the lead is archived
↳ `was_seen`	boolean	Whether the lead was seen
↳ `add_time`	string	When the lead was created (ISO 8601)
↳ `update_time`	string	When the lead was last updated (ISO 8601)
`lead`	object	Single lead object (when lead_id is provided)
↳ `id`	string	Lead ID (UUID)
↳ `title`	string	Lead title
↳ `person_id`	number	ID of the associated person
↳ `organization_id`	number	ID of the associated organization
↳ `owner_id`	number	ID of the lead owner
↳ `value`	object	Lead value
↳ `amount`	number	Value amount
↳ `currency`	string	Currency code (e.g., USD, EUR)
↳ `expected_close_date`	string	Expected close date (YYYY-MM-DD)
↳ `is_archived`	boolean	Whether the lead is archived
↳ `was_seen`	boolean	Whether the lead was seen
↳ `add_time`	string	When the lead was created (ISO 8601)
↳ `update_time`	string	When the lead was last updated (ISO 8601)
`total_items`	number	Total number of leads returned
`has_more`	boolean	Whether more leads are available
`next_start`	number	Offset for fetching the next page
`success`	boolean	Operation success status

`pipedrive_create_lead`

Input

Parameter	Type	Required	Description
`title`	string	Yes	The name of the lead (e.g., "Acme Corp - Website Redesign")
`person_id`	string	No	ID of the person (REQUIRED unless organization_id is provided) (e.g., "456")
`organization_id`	string	No	ID of the organization (REQUIRED unless person_id is provided) (e.g., "789")
`owner_id`	string	No	ID of the user who will own the lead (e.g., "123")
`value_amount`	string	No	Potential value amount (e.g., "10000")
`value_currency`	string	No	Currency code (e.g., "USD", "EUR", "GBP")
`expected_close_date`	string	No	Expected close date in YYYY-MM-DD format (e.g., "2025-04-15")
`visible_to`	string	No	No description

Output

Parameter	Type	Description
`lead`	object	The created lead object
`success`	boolean	Operation success status

`pipedrive_update_lead`

Input

Parameter	Type	Required	Description
`lead_id`	string	Yes	The ID of the lead to update (e.g., "abc123-def456-ghi789")
`title`	string	No	New name for the lead (e.g., "Updated Lead - Premium Package")
`person_id`	string	No	New person ID (e.g., "456")
`organization_id`	string	No	New organization ID (e.g., "789")
`owner_id`	string	No	New owner user ID (e.g., "123")
`value_amount`	string	No	New value amount (e.g., "15000")
`value_currency`	string	No	New currency code (e.g., "USD", "EUR", "GBP")
`expected_close_date`	string	No	New expected close date in YYYY-MM-DD format (e.g., "2025-05-01")
`is_archived`	string	No	No description

Output

Parameter	Type	Description
`lead`	object	The updated lead object
`success`	boolean	Operation success status

`pipedrive_delete_lead`

Input

Parameter	Type	Required	Description
`lead_id`	string	Yes	The ID of the lead to delete (e.g., "abc123-def456-ghi789")

Output

Parameter	Type	Description
`data`	object	Deletion confirmation data
`success`	boolean	Operation success status

`pipedrive_list_persons`

Input

Parameter	Type	Required	Description
`limit`	string	No	Number of results to return (e.g., "50", default: 100, max: 500)
`start`	string	No	No description
`sort`	string	No	Sort field (e.g., "id", "name", "add_time")

Output

Parameter	Type	Description
`persons`	array	Array of person objects
↳ `id`	string	Lead ID (UUID)
↳ `title`	string	Lead title
↳ `person_id`	number	ID of the associated person
↳ `organization_id`	number	ID of the associated organization
↳ `owner_id`	number	ID of the lead owner
↳ `value`	object	Lead value
↳ `amount`	number	Value amount
↳ `currency`	string	Currency code (e.g., USD, EUR)
↳ `expected_close_date`	string	Expected close date (YYYY-MM-DD)
↳ `is_archived`	boolean	Whether the lead is archived
↳ `was_seen`	boolean	Whether the lead was seen
↳ `add_time`	string	When the lead was created (ISO 8601)
↳ `update_time`	string	When the lead was last updated (ISO 8601)
`total_items`	number	Total number of persons returned
`has_more`	boolean	Whether more persons are available
`next_start`	number	Offset for fetching the next page
`success`	boolean	Operation success status

`pipedrive_get_person`

Input

Parameter	Type	Required	Description
`person_id`	string	Yes	ID of the person to retrieve (e.g., "456")

Output

Parameter	Type	Description
`person`	object	The person object
↳ `id`	string	Lead ID (UUID)
↳ `title`	string	Lead title
↳ `person_id`	number	ID of the associated person
↳ `organization_id`	number	ID of the associated organization
↳ `owner_id`	number	ID of the lead owner
↳ `value`	object	Lead value
↳ `amount`	number	Value amount
↳ `currency`	string	Currency code (e.g., USD, EUR)
↳ `expected_close_date`	string	Expected close date (YYYY-MM-DD)
↳ `is_archived`	boolean	Whether the lead is archived
↳ `was_seen`	boolean	Whether the lead was seen
↳ `add_time`	string	When the lead was created (ISO 8601)
↳ `update_time`	string	When the lead was last updated (ISO 8601)
`success`	boolean	Operation success status

`pipedrive_create_person`

Input

Parameter	Type	Required	Description
`name`	string	Yes	Full name of the person (e.g., "John Doe")
`phone`	string	No	Phone number (e.g., "+79991234567")
`email`	string	No	Email address (e.g., "john@example.com")
`org_id`	string	No	ID of the organization this person belongs to (e.g., "789")
`owner_id`	string	No	ID of the user who will own this person (e.g., "123")
`visible_to`	string	No	No description

Output

Parameter	Type	Description
`person`	object	The created person object
↳ `id`	string	Lead ID (UUID)
↳ `title`	string	Lead title
↳ `person_id`	number	ID of the associated person
↳ `organization_id`	number	ID of the associated organization
↳ `owner_id`	number	ID of the lead owner
↳ `value`	object	Lead value
↳ `amount`	number	Value amount
↳ `currency`	string	Currency code (e.g., USD, EUR)
↳ `expected_close_date`	string	Expected close date (YYYY-MM-DD)
↳ `is_archived`	boolean	Whether the lead is archived
↳ `was_seen`	boolean	Whether the lead was seen
↳ `add_time`	string	When the lead was created (ISO 8601)
↳ `update_time`	string	When the lead was last updated (ISO 8601)
`success`	boolean	Operation success status

`pipedrive_update_person`

Input

Parameter	Type	Required	Description
`person_id`	string	Yes	ID of the person to update (e.g., "456")
`name`	string	No	New full name of the person
`phone`	string	No	New phone number
`email`	string	No	New email address
`org_id`	string	No	New organization ID
`owner_id`	string	No	New owner user ID
`visible_to`	string	No	No description

Output

Parameter	Type	Description
`person`	object	The updated person object
↳ `id`	string	Lead ID (UUID)
↳ `title`	string	Lead title
↳ `person_id`	number	ID of the associated person
↳ `organization_id`	number	ID of the associated organization
↳ `owner_id`	number	ID of the lead owner
↳ `value`	object	Lead value
↳ `amount`	number	Value amount
↳ `currency`	string	Currency code (e.g., USD, EUR)
↳ `expected_close_date`	string	Expected close date (YYYY-MM-DD)
↳ `is_archived`	boolean	Whether the lead is archived
↳ `was_seen`	boolean	Whether the lead was seen
↳ `add_time`	string	When the lead was created (ISO 8601)
↳ `update_time`	string	When the lead was last updated (ISO 8601)
`success`	boolean	Operation success status

`pipedrive_delete_person`

Input

Parameter	Type	Required	Description
`person_id`	string	Yes	ID of the person to delete (e.g., "456")

Output

Parameter	Type	Description
`data`	json	Delete response data
`success`	boolean	Operation success status

`pipedrive_list_organizations`

Input

Parameter	Type	Required	Description
`limit`	string	No	Number of results to return (e.g., "50", default: 100, max: 500)
`start`	string	No	No description
`sort`	string	No	Sort field (e.g., "id", "name", "add_time")

Output

Parameter	Type	Description
`organizations`	array	Array of organization objects
`total_items`	number	Total number of organizations returned
`has_more`	boolean	Whether more organizations are available
`next_start`	number	Offset for fetching the next page
`success`	boolean	Operation success status

`pipedrive_get_organization`

Input

Parameter	Type	Required	Description
`org_id`	string	Yes	ID of the organization to retrieve (e.g., "789")

Output

Parameter	Type	Description
`organization`	object	The organization object
`success`	boolean	Operation success status

`pipedrive_create_organization`

Input

Parameter	Type	Required	Description
`name`	string	Yes	Name of the organization (e.g., "Acme Corp")
`owner_id`	string	No	ID of the user who will own this organization
`visible_to`	string	No	No description

Output

Parameter	Type	Description
`organization`	object	The created organization object
`success`	boolean	Operation success status

`pipedrive_update_organization`

Input

Parameter	Type	Required	Description
`org_id`	string	Yes	ID of the organization to update (e.g., "789")
`name`	string	No	New name of the organization
`owner_id`	string	No	New owner user ID
`visible_to`	string	No	No description

Output

Parameter	Type	Description
`organization`	object	The updated organization object
`success`	boolean	Operation success status

`pipedrive_list_notes`

Input

Parameter	Type	Required	Description
`deal_id`	string	No	Filter by deal ID (e.g., "123")
`person_id`	string	No	Filter by person ID (e.g., "456")
`org_id`	string	No	Filter by organization ID (e.g., "789")
`limit`	string	No	Number of results to return (e.g., "50", default: 100)
`start`	string	No	No description

Output

Parameter	Type	Description
`notes`	array	Array of note objects
`total_items`	number	Total number of notes returned
`has_more`	boolean	Whether more notes are available
`next_start`	number	Offset for fetching the next page
`success`	boolean	Operation success status

`pipedrive_create_note`

Input

Parameter	Type	Required	Description
`content`	string	Yes	The content/body of the note
`deal_id`	string	No	ID of the deal to associate the note with (e.g., "123")
`person_id`	string	No	ID of the person to associate the note with (e.g., "456")
`org_id`	string	No	ID of the organization to associate the note with (e.g., "789")

Output

Parameter	Type	Description
`note`	object	The created note object
`success`	boolean	Operation success status

`pipedrive_search`

Input

Parameter	Type	Required	Description
`term`	string	Yes	Search term to look for (e.g., "Acme" or "john@example.com")
`item_type`	string	No	Type of items to search for: deal, person, organization, product, lead (comma-separated)
`limit`	string	No	Number of results to return (e.g., "50")
`start`	string	No	No description

Output

Parameter	Type	Description
`results`	array	Array of search result items
`total_items`	number	Total number of search results
`success`	boolean	Operation success status

`pipedrive_get_products`

Input

Parameter	Type	Required	Description
`product_id`	string	No	Optional: ID of a specific product to retrieve (e.g., "100")
`limit`	string	No	Number of results to return (e.g., "50", default: 100)
`start`	string	No	No description

Output

Parameter	Type	Description
`products`	array	Array of product objects
`product`	object	Single product object (when product_id is provided)
`total_items`	number	Total number of products returned
`has_more`	boolean	Whether more products are available
`next_start`	number	Offset for fetching the next page
`success`	boolean	Operation success status

On this page

Usage Instructions

pipedrive_get_all_deals

pipedrive_get_deal

pipedrive_create_deal

pipedrive_update_deal

pipedrive_get_files

pipedrive_get_mail_messages

pipedrive_get_mail_thread

pipedrive_get_pipelines

pipedrive_get_pipeline_deals

pipedrive_get_projects

pipedrive_create_project

pipedrive_get_activities

pipedrive_create_activity

pipedrive_update_activity

pipedrive_get_leads

pipedrive_create_lead

pipedrive_update_lead

pipedrive_delete_lead

pipedrive_list_persons

pipedrive_get_person

pipedrive_create_person

pipedrive_update_person

pipedrive_delete_person

pipedrive_list_organizations

pipedrive_get_organization

pipedrive_create_organization

pipedrive_update_organization

pipedrive_list_notes

pipedrive_create_note

pipedrive_search

pipedrive_get_products

Start building today

Trusted by over 100,000 builders.

The SaaS platform to build AI agents and run your agentic workforce.