Pipedrive
Interact with Pipedrive CRM
Pipedrive is a powerful sales-focused CRM platform designed to help sales teams manage leads, track deals, and optimize their sales pipeline. Built with simplicity and effectiveness in mind, Pipedrive has become a favorite among sales professionals and growing businesses worldwide for its intuitive visual pipeline management and actionable sales insights.
Pipedrive provides a comprehensive suite of tools for managing the entire sales process from lead capture to deal closure. With its robust API and extensive integration capabilities, Pipedrive enables sales teams to automate repetitive tasks, maintain data consistency, and focus on what matters most—closing deals.
Key features of Pipedrive include:
- Visual Sales Pipeline: Intuitive drag-and-drop interface for managing deals through customizable sales stages
- Lead Management: Comprehensive lead inbox for capturing, qualifying, and converting potential opportunities
- Activity Tracking: Sophisticated system for scheduling and tracking calls, meetings, emails, and tasks
- Project Management: Built-in project tracking capabilities for post-sale customer success and delivery
- Email Integration: Native mailbox integration for seamless communication tracking within the CRM
In Sim, the Pipedrive integration allows your AI agents to seamlessly interact with your sales workflow. This creates opportunities for automated lead qualification, deal creation and updates, activity scheduling, and pipeline management as part of your AI-powered sales processes. The integration enables agents to create, retrieve, update, and manage deals, leads, activities, and projects programmatically, facilitating intelligent sales automation and ensuring that critical customer information is properly tracked and acted upon. By connecting Sim with Pipedrive, you can build AI agents that maintain sales pipeline visibility, automate routine CRM tasks, qualify leads intelligently, and ensure no opportunities slip through the cracks—enhancing sales team productivity and driving consistent revenue growth.
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 (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) |
| 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 |
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 (e.g., "123") |
| Parameter | Type | Description |
|---|
deal | object | Deal object with full details |
success | boolean | Operation success status |
Create a new deal in Pipedrive
| 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 | Status of the deal: open, won, lost |
expected_close_date | string | No | Expected close date in YYYY-MM-DD format (e.g., "2025-06-30") |
| Parameter | Type | Description |
|---|
deal | object | The created deal object |
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 (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 | New status: open, won, lost |
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") |
| Parameter | Type | Description |
|---|
deal | object | The updated deal object |
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 (e.g., "123") |
person_id | string | No | Filter files by person ID (e.g., "456") |
org_id | string | No | Filter files by organization ID (e.g., "789") |
limit | string | No | Number of results to return (e.g., "50", default: 100, max: 500) |
downloadFiles | boolean | No | Download file contents into file outputs |
| 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 |
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 (e.g., "25", default: 50) |
| Parameter | Type | Description |
|---|
messages | array | Array of mail thread objects from Pipedrive mailbox |
total_items | number | Total number of mail threads returned |
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 (e.g., "12345") |
| Parameter | Type | Description |
|---|
messages | array | Array of mail message objects from the thread |
metadata | object | Thread and pagination metadata |
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 (e.g., "50", 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 |
↳ 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 |
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 (e.g., "1") |
stage_id | string | No | Filter by specific stage within the pipeline (e.g., "2") |
status | string | No | Filter by deal status: open, won, lost |
limit | string | No | Number of results to return (e.g., "50", default: 100, max: 500) |
| Parameter | Type | Description |
|---|
deals | array | Array of deal objects from the pipeline |
metadata | object | Pipeline and pagination metadata |
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 (e.g., "123") |
status | string | No | Filter by project status: open, completed, deleted (only for listing all) |
limit | string | No | Number of results to return (e.g., "50", 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) |
total_items | number | Total number of projects returned |
success | boolean | Operation success status |
Create a new project in Pipedrive
| Parameter | Type | Required | Description |
|---|
title | string | Yes | The title of the project (e.g., "Q2 Marketing Campaign") |
description | string | No | Description of the project |
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") |
| Parameter | Type | Description |
|---|
project | object | The created project object |
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 (e.g., "123") |
person_id | string | No | Filter activities by person ID (e.g., "456") |
org_id | string | No | Filter activities by organization ID (e.g., "789") |
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 (e.g., "50", default: 100, max: 500) |
| 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 |
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 (e.g., "Follow up call with John") |
type | string | Yes | Activity type: call, meeting, task, deadline, email, lunch |
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 | Notes for the activity |
| Parameter | Type | Description |
|---|
activity | object | The created activity object |
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 (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 | 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 |
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 (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) |
| 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 |
success | boolean | Operation success status |
Create a new lead in Pipedrive
| 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 | Visibility: 1 (Owner & followers), 3 (Entire company) |
| Parameter | Type | Description |
|---|
lead | object | The created lead object |
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 (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 | Archive the lead: true or false |
| Parameter | Type | Description |
|---|
lead | object | The updated lead object |
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 (e.g., "abc123-def456-ghi789") |
| Parameter | Type | Description |
|---|
data | object | Deletion confirmation data |
success | boolean | Operation success status |