Pipedrive CRM

Create a deal custom field. field_name and field_type are required. For enum/set types, options is required. The response data.field_code is the 40-char hash you must keep to update or delete the field later.

Create a new lead in Pipedrive. Title is required; link to at least one of person_id or organization_id.

Create a new note in Pipedrive. Content is required. Link to a deal, person, organization, or lead.

Create a new organization in Pipedrive. Only name is required.

Create an organization custom field. field_name and field_type are required. For enum/set types, options is required. The response data.field_code is the 40-char hash to keep for later updates.

Create a new person (contact) in Pipedrive. Only name is required.

Create a person custom field. field_name and field_type are required. For enum/set types, options is required. The response data.field_code is the 40-char hash to keep for later updates.

Create a new project phase. name and board_id are required. (Projects add-on; Projects API in public beta.)

Create a new sales pipeline. Only name is required. Set is_deal_probability_enabled to turn on weighted deal probability for the pipeline.

Create a new product in Pipedrive. Only name is required.

Create a product custom field. field_name and field_type are required. For enum/set types, options is required. Product fields use a simpler model: no description, important_fields, or required_fields. The response data.field_code is the 40-char hash to keep for later updates.

Create a new project in Pipedrive. Requires title, board_id, and phase_id. (Requires the Projects add-on; Projects API is in public beta.)

Create a new stage in a pipeline. name and pipeline_id are required. Use is_deal_rot_enabled and days_to_rotten to configure deal rotting.

Create a new task in a project. title and project_id are required. Use boolean is_done/is_milestone (same field names as the GET response); a milestone task must have a due_date. (Projects add-on; Projects API in public beta.)

Delete an activity.

Delete a project board. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true). (Projects add-on; Projects API in public beta.)

Delete a deal. The deal will be marked as deleted and permanently removed after 30 days.

Delete an additional discount from a deal.

Delete a deal custom field by field_code. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Bulk-delete options of a deal enum/set field. Atomic: fails if any ID does not exist. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Remove a follower from a deal.

Delete an installment from a deal. Growth+ plan required.

Remove a line-item product from a deal.

Delete a lead. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Delete a note.

Delete an organization. The organization will be marked as deleted and permanently removed after 30 days.

Delete an organization custom field by field_code. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Bulk-delete options of an organization enum/set field. Atomic: fails if any ID does not exist. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Remove a follower from an organization.

Delete a person. The person will be marked as deleted and permanently removed after 30 days.

Delete a person custom field by field_code. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Bulk-delete options of a person enum/set field. Atomic: fails if any ID does not exist. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Remove a follower from a person.

Delete a project phase. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true). (Projects add-on; Projects API in public beta.)

Delete a pipeline. Marks the pipeline as deleted. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Delete a product. The product will be marked as deleted and permanently removed after 30 days.

Delete a product custom field by field_code. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Bulk-delete options of a product enum/set field. Atomic: fails if any ID does not exist. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Remove a follower from a product.

Delete the image of a product.

Delete a product variation.

Delete a project. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true). (Requires the Projects add-on; Projects API is in public beta.)

Delete a stage. Marks the stage as deleted. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true).

Delete a task. If the task has subtasks, those will also be deleted. Requires PIPEDRIVE_MODE=full (back-compat: PIPEDRIVE_ENABLE_DESTRUCTIVE=true). (Projects add-on; Projects API in public beta.)

Get detailed information about a specific activity by ID.

Get detailed information about a specific project board by ID. (Projects add-on; Projects API in public beta.)

Identify the Pipedrive account this server is connected to: returns the connected company (name, id, and domain) alongside the API key owner's user details. Use it to confirm which company the data is coming from, or to get your user ID.

Get detailed information about a specific deal by ID, including all standard and custom fields.

Get the status of a deal-to-lead conversion job. Status contract: 'completed' (terminal, carries lead_id), 'failed'/'rejected' (terminal, stop polling, no lead produced), 'not_started'/'running' (in-progress, re-poll). Only 'completed' carries lead_id, and conversion status is purged after a few days, so a 404 returned after a prior valid status means the status was purged (terminal stop-polling signal, not a transient error). Use a bounded poll budget (e.g. up to ~6 attempts with short backoff), not an unbounded loop.

Get email messages linked to a deal (company-wide, all users' emails). Returns metadata for emails from any user's mailbox that are linked to this deal. Note: To get full message body, use pipedrive_get_mail_message, but only for emails in YOUR mailbox.

Get the followers changelog for a deal.

Get details of a specific field by its key. Useful for looking up what a 40-character hash field key means.

Get detailed information about a specific lead by UUID.

Get the status of an async lead-to-deal conversion by conversion ID (Pipedrive v2 GET /leads/{id}/convert/status/{conversion_id}).

Get full email message with body. Access depends on visibility settings - messages linked to deals/persons you can access should work, even if sent by other users.

Get a mail thread with messages. Access depends on visibility settings - threads visible within deals/persons you can access should work. Returns 404 if the thread isn't accessible to you.

Get detailed information about a specific note by ID.

Get detailed information about a specific organization by ID.

Get the followers changelog for an organization.

Get detailed information about a specific person by ID.

Get email messages linked to a person (company-wide, all users' emails). Returns metadata for emails from any user's mailbox that are linked to this person. Note: To get full message body, use pipedrive_get_mail_message, but only for emails in YOUR mailbox.

Get the followers changelog for a person.

Get the picture for a person (read-only; returns picture metadata and sized image URLs). Returns an error if the person has no picture.

Get detailed information about a specific project phase by ID. (Projects add-on; Projects API in public beta.)

Get detailed information about a specific product by ID.

Get the followers changelog for a product.

Get the image of a product (returns a single image with a public URL valid for 7 days).

Get detailed information about a specific project by ID. (Requires the Projects add-on; Projects API is in public beta.)

Get the changelog for a project, showing what changed, when, and by whom. Returns paginated entries with actor_user_id, new_values, and old_values. (Projects add-on; Projects API in public beta.)

Get the list of user IDs that have permission to access a project. Returns an array of integer user IDs. (Projects add-on; Projects API in public beta.)

Get detailed information about a specific project template by ID.

Get details of a specific stage by ID.

Get detailed information about a specific task by ID. (Projects add-on; Projects API in public beta.)

Get details of a specific user by ID.

List activities from Pipedrive with optional filtering by owner, deal, person, organization, type, or completion status.

List archived deals with the same filtering as the active deals list (owner, person, organization, pipeline, stage, status). Returns paginated results.

List archived leads from Pipedrive with optional filtering by owner, person, or organization.

List archived projects from Pipedrive with optional filtering by filter, phase, or status. (Projects add-on; Projects API in public beta.)

List all project boards. Returns the complete list (no pagination — the boards endpoint returns all records at once). (Projects add-on; Projects API in public beta.)

List all additional discounts applied to a deal.

List all deal field definitions, including custom fields. Essential for understanding deal data structure.

List all followers for a deal.

List installments across one or more deals. Requires deal_ids. Growth+ plan required.

List line-item products attached to a deal. Returns paginated results.

List deals from Pipedrive with optional filtering by owner, person, organization, pipeline, stage, or status. Returns paginated results.

List active (non-archived) leads from Pipedrive with optional filtering by owner, person, or organization.

List mail threads from YOUR mailbox only (authenticated user). Other users' threads are not accessible. Use folder parameter to filter by inbox, drafts, sent, or archive.

List notes from Pipedrive with optional filtering by deal, person, organization, or lead.

List all organization field definitions, including custom fields. Use this to map 40-character field keys to human-readable names.

List all followers for an organization.

List organizations from Pipedrive with optional filtering by owner or first letter of name.

List all person field definitions, including custom fields. Use to understand contact data structure.

List all followers for a person.

List persons (contacts) from Pipedrive with optional filtering by owner, organization, or first letter of name.

List all phases for a project board. board_id is required. Returns the complete list (no pagination — the phases endpoint returns all records for a board at once). (Projects add-on; Projects API in public beta.)

List sales pipelines in Pipedrive with cursor pagination. Pipelines contain stages that deals move through.

List all product field definitions, including custom fields.

List all followers for a product.

List all variations for a product.

List products from Pipedrive with optional filtering by owner, IDs, or filter.

List all project field definitions, including custom fields. (Projects add-on; Projects API in public beta.)

List tasks for a project you already have the ID for — pass only `id` (the project ID). For broader task queries use pipedrive_list_tasks. (Projects add-on; Projects API in public beta.)

List all project templates available in Pipedrive. Returns paginated results.

List projects from Pipedrive with optional filtering by board, phase, or status. Returns paginated results. (Requires the Projects add-on; Projects API is in public beta.)

List stages with cursor pagination, optionally filtered by pipeline. Stages represent steps in the sales process.

General task query across all projects, with optional project_id, assignee_id, done/milestone, and parent filters. Use for anything beyond a single project's full task list. (Projects add-on; Projects API in public beta.)

List all users in the Pipedrive account. Useful for finding owner IDs when creating or filtering records.

Search for deals by text in title. Supports fuzzy matching by default.

Search for leads in Pipedrive by title or associated contacts.

Search for organizations by name or address.

Search for persons by name, email, or phone number.

Search for products by name, code, or custom fields.

Search for projects in Pipedrive by title. (Requires the Projects add-on; Projects API is in public beta.)

Update an existing activity in Pipedrive. Use this to mark activities as done.

Update an existing project board. Only id is required; all other fields are optional. (Projects add-on; Projects API in public beta.)

Update an existing deal in Pipedrive. Specify the deal ID and any fields to update.

Update an additional discount on a deal. All fields except IDs are optional.

Update a deal custom field by field_code. field_type and field_code cannot be changed.

Bulk-update option labels of a deal enum/set field. Atomic: the whole request fails if any option ID does not exist.

Update an installment on a deal. Growth+ plan required; all body fields optional.

Update a line-item product attached to a deal. All body fields optional.

Update an existing lead in Pipedrive.

Update an existing note in Pipedrive.

Update an existing organization in Pipedrive.

Update an organization custom field by field_code. field_type and field_code cannot be changed.

Bulk-update option labels of an organization enum/set field. Atomic: the whole request fails if any option ID does not exist.

Update an existing person in Pipedrive.

Update a person custom field by field_code. field_type and field_code cannot be changed.

Bulk-update option labels of a person enum/set field. Atomic: the whole request fails if any option ID does not exist.

Update an existing project phase. Only id is required; all other fields are optional. Set board_id to move this phase to a different board. (Projects add-on; Projects API in public beta.)

Update an existing pipeline. Provide the pipeline id and any fields to change.

Update an existing product in Pipedrive.

Update a product custom field by field_code. Only field_name and ui_visibility can be changed (product fields have no description/important_fields/required_fields).

Bulk-update option labels of a product enum/set field. Atomic: the whole request fails if any option ID does not exist.

Update (replace) the image of a product. Provide the image via EITHER file_path OR base64_data (exactly one required). Supports png, jpeg, gif, and webp. Note: file_path is read by the SERVER process via the filesystem and is disabled by default; the operator must set PIPEDRIVE_IMAGE_BASE_DIR and the path must resolve within it; otherwise use base64_data, which is transport-safe.

Update an existing product variation.

Update an existing project in Pipedrive. (Requires the Projects add-on; Projects API is in public beta.)

Update an existing stage. Provide the stage id and any fields to change. Set pipeline_id to move the stage to another pipeline.

Update an existing task. Only id is required; all other fields are optional. Use boolean is_done/is_milestone (same field names as the GET response); a milestone task must have a due_date. (Projects add-on; Projects API in public beta.)

Upload an image for a product. Provide the image via EITHER file_path OR base64_data (exactly one required). Supports png, jpeg, gif, and webp. Note: file_path is read by the SERVER process via the filesystem and is disabled by default; the operator must set PIPEDRIVE_IMAGE_BASE_DIR and the path must resolve within it; otherwise use base64_data, which is transport-safe.