Integrate Pipedrive into your workflow. Manage deals, contacts, sales pipeline, projects, activities, files, and communications with powerful CRM capabilities.
Retrieve all deals from Pipedrive with optional filters
| 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 |
org_id | string | No | If supplied, only deals linked to the specified organization are returned |
pipeline_id | string | No | If supplied, only deals in the specified pipeline are returned |
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 (default: 100, max: 500) |
| Parameter | Type | Description |
|---|
deals | array | Array of deal objects from Pipedrive |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Retrieve detailed information about a specific deal
| Parameter | Type | Required | Description |
|---|
deal_id | string | Yes | The ID of the deal to retrieve |
| Parameter | Type | Description |
|---|
deal | object | Deal object with full details |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Create a new deal in Pipedrive
| Parameter | Type | Required | Description |
|---|
title | string | Yes | The title of the deal |
value | string | No | The monetary value of the deal |
currency | string | No | Currency code (e.g., USD, EUR) |
person_id | string | No | ID of the person this deal is associated with |
org_id | string | No | ID of the organization this deal is associated with |
pipeline_id | string | No | ID of the pipeline this deal should be placed in |
stage_id | string | No | ID of the stage this deal should be placed in |
status | string | No | Status of the deal: open, won, lost |
expected_close_date | string | No | Expected close date in YYYY-MM-DD format |
| Parameter | Type | Description |
|---|
deal | object | The created deal object |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Update an existing deal in Pipedrive
| Parameter | Type | Required | Description |
|---|
deal_id | string | Yes | The ID of the deal to update |
title | string | No | New title for the deal |
value | string | No | New monetary value for the deal |
status | string | No | New status: open, won, lost |
stage_id | string | No | New stage ID for the deal |
expected_close_date | string | No | New expected close date in YYYY-MM-DD format |
| Parameter | Type | Description |
|---|
deal | object | The updated deal object |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Retrieve files from Pipedrive with optional filters
| Parameter | Type | Required | Description |
|---|
deal_id | string | No | Filter files by deal ID |
person_id | string | No | Filter files by person ID |
org_id | string | No | Filter files by organization ID |
limit | string | No | Number of results to return (default: 100, max: 500) |
| Parameter | Type | Description |
|---|
files | array | Array of file objects from Pipedrive |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Retrieve mail threads from Pipedrive mailbox
| Parameter | Type | Required | Description |
|---|
folder | string | No | Filter by folder: inbox, drafts, sent, archive (default: inbox) |
limit | string | No | Number of results to return (default: 50) |
| Parameter | Type | Description |
|---|
messages | array | Array of mail thread objects from Pipedrive mailbox |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Retrieve all messages from a specific mail thread
| Parameter | Type | Required | Description |
|---|
thread_id | string | Yes | The ID of the mail thread |
| Parameter | Type | Description |
|---|
messages | array | Array of mail message objects from the thread |
metadata | object | Operation metadata including thread ID |
success | boolean | Operation success status |
Retrieve all pipelines from Pipedrive
| Parameter | Type | Required | Description |
|---|
sort_by | string | No | Field to sort by: id, update_time, add_time (default: id) |
sort_direction | string | No | Sorting direction: asc, desc (default: asc) |
limit | string | No | Number of results to return (default: 100, max: 500) |
cursor | string | No | For pagination, the marker representing the first item on the next page |
| Parameter | Type | Description |
|---|
pipelines | array | Array of pipeline objects from Pipedrive |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Retrieve all deals in a specific pipeline
| Parameter | Type | Required | Description |
|---|
pipeline_id | string | Yes | The ID of the pipeline |
stage_id | string | No | Filter by specific stage within the pipeline |
status | string | No | Filter by deal status: open, won, lost |
limit | string | No | Number of results to return (default: 100, max: 500) |
| Parameter | Type | Description |
|---|
deals | array | Array of deal objects from the pipeline |
metadata | object | Operation metadata including pipeline ID |
success | boolean | Operation success status |
Retrieve all projects or a specific project from Pipedrive
| Parameter | Type | Required | Description |
|---|
project_id | string | No | Optional: ID of a specific project to retrieve |
status | string | No | Filter by project status: open, completed, deleted (only for listing all) |
limit | string | No | Number of results to return (default: 100, max: 500, only for listing all) |
| Parameter | Type | Description |
|---|
projects | array | Array of project objects (when listing all) |
project | object | Single project object (when project_id is provided) |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Create a new project in Pipedrive
| Parameter | Type | Required | Description |
|---|
title | string | Yes | The title of the project |
description | string | No | Description of the project |
start_date | string | No | Project start date in YYYY-MM-DD format |
end_date | string | No | Project end date in YYYY-MM-DD format |
| Parameter | Type | Description |
|---|
project | object | The created project object |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Retrieve activities (tasks) from Pipedrive with optional filters
| Parameter | Type | Required | Description |
|---|
deal_id | string | No | Filter activities by deal ID |
person_id | string | No | Filter activities by person ID |
org_id | string | No | Filter activities by organization ID |
type | string | No | Filter by activity type (call, meeting, task, deadline, email, lunch) |
done | string | No | Filter by completion status: 0 for not done, 1 for done |
limit | string | No | Number of results to return (default: 100, max: 500) |
| Parameter | Type | Description |
|---|
activities | array | Array of activity objects from Pipedrive |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Create a new activity (task) in Pipedrive
| Parameter | Type | Required | Description |
|---|
subject | string | Yes | The subject/title of the activity |
type | string | Yes | Activity type: call, meeting, task, deadline, email, lunch |
due_date | string | Yes | Due date in YYYY-MM-DD format |
due_time | string | No | Due time in HH:MM format |
duration | string | No | Duration in HH:MM format |
deal_id | string | No | ID of the deal to associate with |
person_id | string | No | ID of the person to associate with |
org_id | string | No | ID of the organization to associate with |
note | string | No | Notes for the activity |
| Parameter | Type | Description |
|---|
activity | object | The created activity object |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Update an existing activity (task) in Pipedrive
| Parameter | Type | Required | Description |
|---|
activity_id | string | Yes | The ID of the activity to update |
subject | string | No | New subject/title for the activity |
due_date | string | No | New due date in YYYY-MM-DD format |
due_time | string | No | New due time in HH:MM format |
duration | string | No | New duration in HH:MM format |
done | string | No | Mark as done: 0 for not done, 1 for done |
note | string | No | New notes for the activity |
| Parameter | Type | Description |
|---|
activity | object | The updated activity object |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Retrieve all leads or a specific lead from Pipedrive
| Parameter | Type | Required | Description |
|---|
lead_id | string | No | Optional: ID of a specific lead to retrieve |
archived | string | No | Get archived leads instead of active ones |
owner_id | string | No | Filter by owner user ID |
person_id | string | No | Filter by person ID |
organization_id | string | No | Filter by organization ID |
limit | string | No | Number of results to return (default: 100, max: 500) |
| Parameter | Type | Description |
|---|
leads | array | Array of lead objects (when listing all) |
lead | object | Single lead object (when lead_id is provided) |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Create a new lead in Pipedrive
| Parameter | Type | Required | Description |
|---|
title | string | Yes | The name of the lead |
person_id | string | No | ID of the person (REQUIRED unless organization_id is provided) |
organization_id | string | No | ID of the organization (REQUIRED unless person_id is provided) |
owner_id | string | No | ID of the user who will own the lead |
value_amount | string | No | Potential value amount |
value_currency | string | No | Currency code (e.g., USD, EUR) |
expected_close_date | string | No | Expected close date in YYYY-MM-DD format |
visible_to | string | No | Visibility: 1 (Owner & followers), 3 (Entire company) |
| Parameter | Type | Description |
|---|
lead | object | The created lead object |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Update an existing lead in Pipedrive
| Parameter | Type | Required | Description |
|---|
lead_id | string | Yes | The ID of the lead to update |
title | string | No | New name for the lead |
person_id | string | No | New person ID |
organization_id | string | No | New organization ID |
owner_id | string | No | New owner user ID |
value_amount | string | No | New value amount |
value_currency | string | No | New currency code (e.g., USD, EUR) |
expected_close_date | string | No | New expected close date in YYYY-MM-DD format |
is_archived | string | No | Archive the lead: true or false |
| Parameter | Type | Description |
|---|
lead | object | The updated lead object |
metadata | object | Operation metadata |
success | boolean | Operation success status |
Delete a specific lead from Pipedrive
| Parameter | Type | Required | Description |
|---|
lead_id | string | Yes | The ID of the lead to delete |
| Parameter | Type | Description |
|---|
data | object | Deletion confirmation data |
metadata | object | Operation metadata |
success | boolean | Operation success status |
- Category:
tools
- Type:
pipedrive