--- title: Pipedrive API Integration on Truto slug: pipedrive category: CRM canonical: "https://truto.one/integrations/detail/pipedrive/" --- # Pipedrive API Integration on Truto **Category:** CRM **Status:** Generally available ## Unified APIs ### Unified CRM API - **Accounts** — The accounts represent a company in a CRM. - **Associations** — - **Contacts** — The contacts represent an existing point of contact at a company in a CRM. - **Engagement Types** — The engagement types represent an interaction activity in a CRM. - **Engagements** — The engagements represent an interaction noted in a CRM. - **Fields** — The fields of entities in a CRM. - **Leads** — The leads represent a potential customer in a CRM. - **Notes** — The notes represent a note on another object in a CRM. - **Opportunities** — The opportunities represent an opportunity in a CRM. - **Pipelines** — - **Stages** — The stages represent a stage of an opportunity in a CRM. - **Tasks** — The tasks represent a task in a CRM. - **Users** — The users represent a user in a CRM. ### Unified User Directory API - **Me** — - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ## MCP-ready AI tools Truto exposes 117 tools for Pipedrive that AI agents can call directly. - **list_all_pipedrive_users** — List all users in Pipedrive. Returns fields such as id, name, email, phone, activated, last_login, created, modified, role_id, and timezone_name for each user. - **get_single_pipedrive_user_by_id** — Get details for a specific user in Pipedrive using id. Returns fields like id, name, email, active status, and role information in the response. - **create_a_pipedrive_user** — Create a new user in Pipedrive using email. Returns fields such as id, name, email, active_flag, activated, default_currency, locale, created, and last_login in the response. - **update_a_pipedrive_user_by_id** — Update a user's active_flag in Pipedrive using id. Returns success status and updated user data. - **list_all_pipedrive_persons** — List all persons in Pipedrive. Returns person details including id, name, organization, owner, email, and phone. Fields such as ims, postal_address, notes, birthday, and job_title are included only if contact sync is enabled. - **get_single_pipedrive_person_by_id** — Get details of a specific person in Pipedrive using id. Returns fields like ims, postal_address, notes, birthday, and job_title if contact sync is enabled. - **create_a_pipedrive_person** — Create a new person in Pipedrive. Returns key person details including id, name, owner_id, org_id, emails, phones, and marketing_status in the response. - **update_a_pipedrive_person_by_id** — Update a specific person in Pipedrive using the id. Returns updated fields including name, owner_id, org_id, emails, phones, visible_to, label_ids, and marketing_status. - **delete_a_pipedrive_person_by_id** — Delete a person in Pipedrive by id. The person is marked as deleted and permanently removed after 30 days. Returns a success status and data confirming deletion. - **pipedrive_persons_search** — Search persons in Pipedrive using required term parameter. Returns matched persons with key details such as id, name, organization info, and contact details. - **list_all_pipedrive_deals** — List all not archived deals in Pipedrive. Returns key fields such as id, title, value, currency, status, owner_id, org_id, and update_time in the response. - **get_single_pipedrive_deal_by_id** — Get details of a specific deal in Pipedrive. Requires id. Returns fields like title, value, status, and related organization and person information in the response. - **create_a_pipedrive_deal** — Create a new deal in Pipedrive. Requires title. Returns data including deal id, title, value, status, owner_id, and other core deal attributes. - **update_a_pipedrive_deal_by_id** — Update a specific deal in Pipedrive using id. Returns updated deal fields such as title, status, value, currency, owner_id, and stage_id in the response. - **delete_a_pipedrive_deal_by_id** — Delete a specific deal in Pipedrive. Requires id. Marks a deal as deleted and permanently removes it after 30 days. Returns a confirmation of deletion status in the response. - **list_all_pipedrive_notes** — List all notes in Pipedrive. Returns note fields including id, content, user_id, deal_id, person_id, org_id, and timestamps (add_time, update_time). - **get_single_pipedrive_note_by_id** — Get details about a specific note in Pipedrive using id. Returns fields describing the note's content, related entities, and timestamps. - **create_a_pipedrive_note** — Create a new note in Pipedrive. Requires the content field and one of lead_id, deal_id, person_id, org_id, or project_id. Returns the created note data including its id, content, and associations. - **update_a_pipedrive_note_by_id** — Update a specific note in Pipedrive using id. Returns the updated note fields such as content, pinned flags, and related entity IDs (deal_id, person_id, org_id, etc.). - **delete_a_pipedrive_note_by_id** — Delete a specific note in Pipedrive. Requires id. Returns a 'success' flag indicating operation result and a 'data' field confirming deletion. - **list_all_pipedrive_organizations** — List all organizations in Pipedrive. Returns fields such as organization name, owner details, and related metadata in the response. - **get_single_pipedrive_organization_by_id** — Get details of an organization in Pipedrive using id. Returns fields such as id, name, address, owner_id, and related deal and activity counts. - **create_a_pipedrive_organization** — Create a new organization in Pipedrive. Requires name. Returns id, name, owner_id, add_time, update_time, visible_to, label_ids, address, and custom_fields in the response. - **update_a_pipedrive_organization_by_id** — Update an organization in Pipedrive using id. Returns updated fields such as name, owner_id, visible_to, label_ids, address, and custom_fields in the response. - **delete_a_pipedrive_organization_by_id** — Delete an organization in Pipedrive. Requires id. Marks the organization as deleted and it will be permanently removed after 30 days. Returns success status and data of the deleted organization in the response. - **list_all_pipedrive_activities** — List all activities in Pipedrive. Returns key activity details such as id, subject, type, due_date, and owner_id in the response. - **get_single_pipedrive_activity_by_id** — Get details of a specific activity in Pipedrive using id. Returns key fields such as subject, type, due_date, done, and details about related items like deal, person, and organization. - **create_a_pipedrive_activity** — Create a new activity in Pipedrive. Returns fields such as id, subject, type, due_date, owner_id, and done in the response. - **update_a_pipedrive_activity_by_id** — Update an activity in Pipedrive using id. Returns updated fields such as subject, type, owner_id, deal_id, and done to confirm the modification. - **delete_a_pipedrive_activity_by_id** — Delete an activity in Pipedrive. Requires id. Marks the activity as deleted and it will be permanently removed after 30 days. - **list_all_pipedrive_leads** — List all not archived leads in Pipedrive sorted by creation time. Returns fields such as id, title, owner_id, creator_id, was_seen, expected_close_date, next_activity_id, add_time, and update_time. - **get_single_pipedrive_lead_by_id** — Get details of a specific lead in Pipedrive using id. Returns lead fields including title, owner_id, value, and custom deal fields if set. - **create_a_pipedrive_lead** — Create a new lead in Pipedrive. Requires title and either person_id or organization_id. Returns lead details including id, title, value, owner_id, and visibility settings. - **delete_a_pipedrive_lead_by_id** — Delete a specific lead in Pipedrive using the id. Returns confirmation of deletion including the deleted lead's id and success status. - **update_a_pipedrive_lead_by_id** — Update an existing lead in Pipedrive by id. Only properties provided in the request are updated. Returns updated lead details including title, owner_id, person_id, organization_id, value, and custom field values. - **list_all_pipedrive_stages** — List all stages in Pipedrive. Returns fields such as id, name, order_nr, and pipeline_id for each stage. - **get_single_pipedrive_stage_by_id** — Get details about a specific stage in Pipedrive using id. Returns key fields such as stage name, order number, and pipeline_id in the response. - **create_a_pipedrive_stage** — Create a new stage in Pipedrive. Requires name and pipeline_id. Returns the created stage id in the response. - **update_a_pipedrive_stage_by_id** — Update a specific stage in Pipedrive using id. Returns updated stage details including name, pipeline_id, deal_probability, is_deal_rot_enabled, and days_to_rotten. - **delete_a_pipedrive_stage_by_id** — Delete a specific stage in Pipedrive using id. Marks the stage as deleted and removes it from active use. Returns confirmation of deletion in the response. - **list_all_pipedrive_activity_types** — List all activity types in Pipedrive. Returns each activity type's id, name, key_string, icon_key, and order_nr fields used to define and organize activity types. - **create_a_pipedrive_activity_type** — Create a new activity type in Pipedrive. Requires name and icon_key in the request body. Returns fields such as id, name, icon_key, and color representing the created activity type. - **update_a_pipedrive_activity_type_by_id** — Update an existing activity type in Pipedrive using id. Returns activity type details including name, icon_key, color, and order_nr. - **delete_a_pipedrive_activity_type_by_id** — Delete a specific activity type in Pipedrive. Requires id. Marks the activity type as deleted and returns confirmation of the deletion status in the response. - **pipedrive_activity_types_bulk_delete** — Delete multiple activity types in Pipedrive in bulk. Requires ids parameter (comma-separated activity type IDs). Returns confirmation of deleted activity types. - **list_all_pipedrive_person_fields** — List all person fields in Pipedrive. Returns data about all person fields, including marketing_status if the Campaigns product is enabled. - **get_single_pipedrive_person_field_by_id** — Get data about a specific person field in Pipedrive. Requires id. Returns field details such as name, key, field_type, and options that define the field configuration. - **create_a_pipedrive_person_field** — Create a new person field in Pipedrive. Requires name and field_type. Returns field details including id, name, key, field_type, and add_visible_flag in the response. - **update_a_pipedrive_person_field_by_id** — Update a specific person field in Pipedrive using id. Returns updated field details including name, options, and add_visible_flag. - **delete_a_pipedrive_person_field_by_id** — Delete a person field in Pipedrive by id. Marks the specified field as deleted. Returns the deleted field’s details including its id and status information. - **list_all_pipedrive_organization_fields** — List all organization fields in Pipedrive. Returns field id, name, key, and other field details for all organization fields. - **get_single_pipedrive_organization_field_by_id** — Get details of a specific organization field in Pipedrive using id. Returns field id, name, key, field_type, and editability details. - **create_a_pipedrive_organization_field** — Create a new organization field in Pipedrive. Requires name and field_type. Returns field id, name, field_type, and visibility settings in the response. - **update_a_pipedrive_organization_field_by_id** — Update an organization field in Pipedrive using id. Returns key details of the updated field including its name, type, visibility, and options if applicable. - **delete_a_pipedrive_organization_field_by_id** — Delete an organization field in Pipedrive using the id. Marks the specified field as deleted. No content is returned in the response. - **list_all_pipedrive_deal_fields** — List all deal fields in Pipedrive. Returns field id, key, name, field_type, and options for each deal field. - **get_single_pipedrive_deal_field_by_id** — Get details about a specific deal field in Pipedrive. Requires id. Returns field id, key, name, field_type, and other properties describing the deal field. - **create_a_pipedrive_deal_field** — Create a new deal field in Pipedrive. Requires name and field_type. Returns the created deal field details, including id, name, and field_type. - **update_a_pipedrive_deal_field_by_id** — Update a specific deal field in Pipedrive using id. Returns the updated deal field including key details such as name, options, and visibility settings. - **delete_a_pipedrive_deal_field_by_id** — Delete a specific deal field in Pipedrive using id. Marks the field as deleted and removes it from active use. Returns confirmation of deletion in the response. - **list_all_pipedrive_filters** — List all filters in Pipedrive. Returns filter details including id, name, type, and conditions in the response. - **get_single_pipedrive_filter_by_id** — Get details about a specific filter in Pipedrive using id. Returns filter data including its condition lines in the response. - **list_all_pipedrive_person_search** — Search persons in Pipedrive using the required parameter term. Returns key fields such as id, name, email, phone, and organization details for each matched person. - **list_all_pipedrive_pipelines** — Get all pipelines in Pipedrive. Returns details about each pipeline such as id, name, and stages. Supports sorting by id, update_time, or add_time. - **get_single_pipedrive_pipeline_by_id** — Get data about a specific pipeline in Pipedrive using id. Returns fields such as id, name, and active status in the response. - **create_a_pipedrive_pipeline** — Create a new pipeline in Pipedrive. Requires name. Returns the created pipeline data including id, name, and deal probability settings. - **update_a_pipedrive_pipeline_by_id** — Update a pipeline in Pipedrive using id. Returns updated fields including name and is_deal_probability_enabled to confirm successful update. - **delete_a_pipedrive_pipeline_by_id** — Delete a specific pipeline in Pipedrive. Requires id. Marks the pipeline as deleted and returns confirmation of the deletion. - **list_all_pipedrive_roles** — List all roles in Pipedrive. Returns an array of roles within the company including key role details such as id, name, and permissions. - **get_single_pipedrive_role_by_id** — Get details about a specific role in Pipedrive. Requires id. Returns fields such as id, name, and permissions describing the role configuration. - **update_a_pipedrive_role_by_id** — Update role details in Pipedrive. Requires id. This updates the parent_role_id and/or name of the specified role. The response returns the updated role object with its new details. - **delete_a_pipedrive_role_by_id** — Delete a specific role in Pipedrive using its id. Marks the role as deleted. Returns confirmation of deletion in the response. - **list_all_pipedrive_billing** — List all add-ons for a single company in Pipedrive. Returns key fields in the response under 'data', including details about each add-on and success status. - **list_all_pipedrive_user_permissions** — List aggregated permissions for a specific user in Pipedrive. Requires id. Returns permission details aggregated from all assigned permission sets. - **list_all_pipedrive_mailbox** — List mail threads in a specified folder in Pipedrive. Requires folder parameter. Returns mail threads ordered by the most recent message with key fields such as thread details and participants. - **list_all_pipedrive_organizations_search** — Search organizations in Pipedrive by term. Requires term. Returns matching organizations with key fields such as name, address, notes, and custom_fields. - **list_all_pipedrive_leads_search** — Search leads in Pipedrive by term. Requires term. Returns lead id, title, person_id, organization_id, and other key lead fields. - **list_all_pipedrive_deals_search** — Search deals in Pipedrive by term. Requires term. Returns deal details such as id, title, person and organization associations, and status fields in the response. - **list_all_pipedrive_search_users** — Find users in Pipedrive by name. Requires term. Returns user information including id, name, and email matching the given term. - **list_all_pipedrive_activity_fields** — List all activity fields in Pipedrive. Returns key field information such as name, key, field_type, and custom_flag within the data array. - **list_all_pipedrive_calllogs** — List all call logs assigned to a particular user in Pipedrive. Returns call log details including id, duration, and user assignment information. - **get_single_pipedrive_calllog_by_id** — Get details of a specific call log in Pipedrive using id. Returns key fields such as duration, start_time, and participant details. - **create_a_pipedrive_calllog** — Create a new call log in Pipedrive. Requires outcome, to_phone_number, start_time, and end_time. Returns fields such as id, outcome, duration, start_time, end_time, and associated entity IDs (person_id, org_id, deal_id, lead_id). - **delete_a_pipedrive_calllog_by_id** — Delete a call log in Pipedrive using id. If an audio recording is attached, it will also be deleted. The related activity remains unaffected. Returns success status in the response. - **list_all_pipedrive_currencies** — List all supported currencies in Pipedrive. Returns fields such as code (ISO 4217 currency code), symbol, and is_custom_flag for each currency. - **list_all_pipedrive_archived_deals** — List all archived deals in Pipedrive. Returns fields such as id, title, value, currency, stage_id, and owner_id for each deal. - **list_all_pipedrive_deals_summary** — Get a summary of all not archived deals in Pipedrive. Returns key statistics about deals such as their total counts and statuses across pipelines and stages. - **list_all_pipedrive_deals_timeline** — Get deals timeline in Pipedrive. Requires start_date, interval, amount, and field_key. Returns grouped deal intervals with key data including counts, values, and totals_converted when applicable. - **list_all_pipedrive_tasks** — List all tasks in Pipedrive. Returns task details such as id, title, due date, and completion status in the response. - **get_single_pipedrive_task_by_id** — Get details of a specific task in Pipedrive. Requires id. Returns key task fields in the data object. - **create_a_pipedrive_task** — Create a new task in Pipedrive. Requires title and project_id. Returns key fields including id, title, project_id, description, assignee_id, done, and due_date for the created task. - **update_a_pipedrive_task_by_id** — Update a task in Pipedrive using id. Returns fields like title, description, due_date, project_id, and done status in the response. - **delete_a_pipedrive_task_by_id** — Delete a specific task in Pipedrive using id. Marks the task as deleted and also deletes any related subtasks. Returns success status and deleted task data in the response. - **list_all_pipedrive_products** — List all products in Pipedrive. Returns an array of product objects with key fields such as id, name, add_time, and update_time. - **get_single_pipedrive_product_by_id** — Get information about a specific product in Pipedrive. Requires id. Returns fields such as name, prices, and active status in the response. - **create_a_pipedrive_product** — Create a new product in Pipedrive. Requires name. Returns product fields including id, name, code, description, unit, tax, category, owner_id, is_linkable, visible_to, prices, billing_frequency, and billing_frequency_cycles. - **update_a_pipedrive_product_by_id** — Update a product in Pipedrive using id. Updates key fields such as name, code, description, unit, tax, category, pricing details, and visibility. Returns updated product data in the response. - **delete_a_pipedrive_product_by_id** — Delete a specific product in Pipedrive using id. Marks the product as deleted; it is permanently removed after 30 days. Returns confirmation of deletion in the response. - **list_all_pipedrive_search_products** — Search products in Pipedrive by term. Requires term parameter with minimum 2 characters. Returns matching products with key fields such as id, name, and code. - **list_all_pipedrive_product_deals** — Get deals linked to a specific product in Pipedrive. Requires product id. Returns deal data including key details about each deal associated with the specified product. - **list_all_pipedrive_product_files** — List files attached to a specific product in Pipedrive. Requires product_id. Returns data including file details such as name, type, and update information. - **list_all_pipedrive_product_followers** — List followers of a product in Pipedrive. Requires product_id. Returns user details for all followers of the specified product. - **list_all_pipedrive_product_permitted_users** — List users permitted to access a specific product in Pipedrive. Requires product_id. Returns success status and a data array containing permitted user details. - **list_all_pipedrive_product_fields** — List all product fields in Pipedrive. Returns field metadata including field name, type, and configuration details for all product fields in the company. - **get_single_pipedrive_product_field_by_id** — Get metadata about a specific product field in Pipedrive. Requires id. Returns key field properties including name, field_type, and editability metadata in the response. - **list_all_pipedrive_lead_labels** — List all lead labels in Pipedrive. Returns an array of label objects in data, each representing a lead label. This endpoint does not support pagination and always returns all labels. - **create_a_pipedrive_lead_label** — Create a new lead label in Pipedrive. Requires name and color. Returns success status and data containing details of the created label including its id, name, and color. - **update_a_pipedrive_lead_label_by_id** — Update a lead label in Pipedrive using id. Only provided properties such as name and color are updated. Returns the label's id, name, and color in the response. - **delete_a_pipedrive_lead_label_by_id** — Delete a specific lead label in Pipedrive using id. Returns success status and data confirming deletion. - **list_all_pipedrive_files** — List all files in Pipedrive. Returns fields such as file id, name, type, and update_time in the response. - **get_single_pipedrive_file_by_id** — Get details of a specific file in Pipedrive using id. Returns key fields such as id, name, and file_type describing the file metadata. - **pipedrive_files_download** — Download a specific file in Pipedrive using id. Returns the file content for the requested file. - **create_a_pipedrive_file** — Create a new file in Pipedrive. Requires file parameter in multipart/form-data. Returns file id, name, and associated resource identifiers such as deal_id, person_id, or org_id in the response. - **update_a_pipedrive_file_by_id** — Update file details in Pipedrive. Requires id. Returns updated file fields such as id, name, description, and other file metadata. - **delete_a_pipedrive_file_by_id** — Delete a file in Pipedrive by marking it as deleted. Requires id. The file will be permanently removed after 30 days. Returns confirmation of deletion status. - **pipedrive_files_remote** — Create a remote file in Pipedrive and link it to an item. Requires file_type, title, item_type, item_id, and remote_location. Returns file id, title, and remote location details in the response. - **pipedrive_files_remote_link** — Link an existing remote file from Google Drive to an item in Pipedrive. Requires item_type, item_id, remote_id, and remote_location. Returns the linked file details including id, item_type, and remote_location in the response. ## How it works 1. **Link your customer's Pipedrive account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Pipedrive.** The Proxy API is a 1-to-1 mapping of the Pipedrive API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Log calls and engagement data into Pipedrive automatically** — Communication platforms like VoIP, SMS, or email tools can search for contacts via phone or email using person search, then push call logs, activities, and notes directly onto the matched Person or Deal — eliminating manual data entry for sales reps. - **Sync qualified leads into the sales pipeline from external tools** — Lead generation and marketing automation platforms can create Organizations, Persons, and Deals in Pipedrive when a prospect qualifies, placing them in the right pipeline stage with full context so AEs can pick up warm leads without switching tools. - **Trigger downstream workflows when deals change stage** — Quoting, billing, or contract management tools can read deal data, associated products, and stage information from Pipedrive, then update deal status and attach files when external actions complete — like marking a deal as Closed Won after a proposal is signed. - **Enrich CRM records with external data** — Data enrichment and revenue intelligence platforms can pull Persons and Organizations from Pipedrive, match them against external sources, and write enriched data back into standard or custom fields to keep the CRM current without manual updates. - **Provide sales managers with cross-platform pipeline visibility** — Reporting and analytics SaaS can pull deals, stages, pipelines, activities, and deal summaries from Pipedrive to build unified dashboards that give managers forecasting and rep performance insights alongside data from other tools. ## What you can build - **Caller ID screen pop with deal context** — Search Pipedrive persons by phone number on inbound calls and surface the contact's name, organization, and open deals to the rep before they pick up. - **Automatic call log and recording sync** — Push call duration, outcome, and audio file attachments into Pipedrive as call logs and files linked to the relevant person or deal after every conversation. - **One-click lead-to-deal pipeline injection** — Create an Organization, Person, and Deal in Pipedrive in a single flow from your app, assigning the deal to a specific rep and stage with notes containing the full outreach history. - **Dynamic custom field mapping UI** — Fetch person fields, deal fields, and organization fields from Pipedrive at runtime so your users can map your app's data model to their unique custom field configurations without hardcoding. - **Deal stage change automation** — Read pipelines and stages from Pipedrive to let users map external events — like a signed contract or completed payment — to automatic deal stage updates and note creation. - **Bi-directional contact and account sync** — Use Truto's Unified CRM API to keep contacts, accounts, and related metadata in sync between your product and Pipedrive with search-based deduplication and incremental updates. ## FAQs ### What authentication method does the Pipedrive integration use? Pipedrive supports OAuth 2.0 for third-party integrations. Truto handles the full OAuth flow, token refresh, and credential storage so your team doesn't need to manage auth directly. ### Can I read and write custom fields in Pipedrive through Truto? Yes. You can list all custom fields for Persons, Deals, and Organizations using the dedicated field endpoints (e.g., list_all_pipedrive_person_fields, list_all_pipedrive_deal_fields). You can also create, update, and delete custom field definitions, and read/write custom field values on records. ### How does Truto's Unified CRM API map to Pipedrive's data model? Pipedrive Organizations map to Accounts, Persons map to Contacts, Deals map to Opportunities, and Activities map to Engagements. Pipelines, Stages, Notes, Tasks, and Users all have direct unified model equivalents. Truto normalizes these so the same code works across CRMs. ### Does the integration support search and deduplication? Yes. Pipedrive exposes dedicated search endpoints for Persons, Organizations, Deals, Leads, Products, and Users. You can search by email, phone, name, or other terms to resolve identities and prevent duplicate record creation. ### What operations are supported beyond basic CRUD? Beyond standard create, read, update, and delete on core objects, the integration supports deal summaries, deal timelines, archived deals, file uploads and downloads, remote file linking, call log management, product-deal associations, lead labels, activity types, filters, roles, billing info, user permissions, and mailbox access. ### Does Truto handle Pipedrive's pagination and rate limits? Yes. Truto manages cursor-based pagination and respects Pipedrive's API rate limits automatically, so your application receives complete result sets without needing to implement retry logic or pagination handling. ## Related reading - [How to Integrate with the Pipedrive API (2026 Engineering Guide)](https://truto.one/blog/how-to-integrate-with-the-pipedrive-api-2026-engineering-guide/) — A technical guide to building reliable Pipedrive API integrations in 2026, covering token-based rate limits, 40-character custom field hashes, OAuth 2.0, and pagination quirks.