# Pipedrive — how to use (mcp.ai)

Pipedrive is a sales management tool built around pipeline visualization, lead tracking, activity reminders, and automation to keep deals progressing

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_pipedrive?ms=1784645820000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `pipedrive_add_a_call_log`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/pipedrive`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/pipedrive/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/pipedrive/add/a/call/log` — Adds a new call log.
  - body: { note?: string, org_id?: integer, deal_id?: integer, lead_id?: string, outcome: string, subject?: string, user_id?: integer, duration?: string, end_time: string, person_id?: integer, start_time: string, activity_id?: integer, to_phone_number: string, from_phone_number?: string }
- `POST https://api.mcp.ai/api/pipedrive/add/a/channel` — New messaging channel added; registration limited to admins. utilizes getconversations endpoint for data retrieval. requires messengers integration oauth scope and a prepared messaging app extension m
  - body: { name: string, avatar_url?: string, provider_type?: string, template_support?: boolean, provider_channel_id: string }
- `POST https://api.mcp.ai/api/pipedrive/add/a/comment/to/a/note` — Adds a new comment to a note.
  - body: { id: integer, content: string }
- `POST https://api.mcp.ai/api/pipedrive/add/a/deal` — Add a new deal to pipedrive with any custom fields, which vary by account and are identified by long hash keys. check dealfields for existing custom fields. for details, visit the tutorial on adding a
- `POST https://api.mcp.ai/api/pipedrive/add/a/follower/to/a/deal` — Adds a follower to a deal.
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/follower/to/a/person` — Adds a follower to a person.
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/follower/to/a/product` — Adds a follower to a product.
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/follower/to/an/organization` — Adds a follower to an organization.
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/lead` — Pipedrive api lets you add leads linked to people or organizations and tags them with 'api' source. custom fields from deals apply to leads and appear in responses if set. details are in the tutorials
  - body: { title: string, owner_id?: integer, was_seen?: boolean, label_ids?: string[], person_id?: integer, value__amount?: integer, organization_id?: integer, value__currency?: string, expected_close_date?: string }
- `POST https://api.mcp.ai/api/pipedrive/add/a/lead/label` — Creates a lead label.
  - body: { name: string, color: string }
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/deal/field` — Adds a new deal field. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/adding-a-new-custom-field" target=" blank" rel="noopener noreferrer">adding a new custom fie
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/filter` — New filter creation returns an id. only one primary condition group with 'and' and two secondary groups (one 'and', one 'or') are supported. future syntax expansion possible. see tutorial for details.
  - body: { name: string }
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/goal` — Adds a new goal. along with adding a new goal, a report is created to track the progress of your goal.
  - body: { title?: string, interval: string }
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/organization/field` — Adds a new organization field. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/adding-a-new-custom-field" target=" blank" rel="noopener noreferrer">adding a new cu
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/person/field` — Adds a new person field. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/adding-a-new-custom-field" target=" blank" rel="noopener noreferrer">adding a new custom f
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/pipeline` — Adds a new pipeline.
  - body: { name: string, order_nr?: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/product/field` — Adds a new product field. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/adding-a-new-custom-field" target=" blank" rel="noopener noreferrer">adding a new custom 
  - body: { name: string, options?: object[], field_type: string }
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/stage` — Adds a new stage, returns the id upon success.
  - body: { name: string, pipeline_id: integer, rotten_days?: integer, rotten_flag?: boolean, deal_probability?: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/team` — Adds a new team to the company and returns the created object.
  - body: { name: string, users?: integer[], manager_id: integer, description?: string }
- `POST https://api.mcp.ai/api/pipedrive/add/a/new/user` — Adds a new user to the company, returns the id upon success.
  - body: { email: string, access?: object[], active_flag?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/add/a/note` — Add a note to a deal, person, organization, lead, or project in pipedrive. at least one of deal id, person id, org id, lead id, or project id must be provided.
  - body: { org_id?: integer, content: string, deal_id?: integer, lead_id?: string, add_time?: string, person_id?: integer, project_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/participant/to/a/deal` — Adds a participant to a deal.
  - body: { id: integer, person_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/person` — Add a new contact in pipedrive with optional custom fields unique to each account found using the `personfields` endpoint. the endpoint also handles `data.marketing status` for campaigns product users
- `POST https://api.mcp.ai/api/pipedrive/add/a/product` — Adds a new product to the products inventory. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/adding-a-product" target=" blank" rel="noopener noreferrer">adding a 
- `POST https://api.mcp.ai/api/pipedrive/add/a/product/to/a/deal` — Adds a product to a deal, creating a new item called a deal-product.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/project` — Adds a new project. note that you can supply additional custom fields along with the request that are not described here. these custom fields are different for each pipedrive account and can be recogn
- `POST https://api.mcp.ai/api/pipedrive/add/a/recurring/subscription` — Adds a new recurring subscription.
  - body: { deal_id: integer, currency: string, infinite?: boolean, payments?: object[], start_date: string, description?: string, cadence_type: string, cycle_amount: integer, cycles_count?: integer, update_deal_value?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/add/a/role` — Adds a new role.
  - body: { name: string, parent_role_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/a/task` — Adds a new task.
- `POST https://api.mcp.ai/api/pipedrive/add/an/activity` — New activity added. response includes `more activities scheduled in context` to show if more are planned with the same entity. see tutorial on adding activities [here](https://pipedrive.readme.io/docs
- `POST https://api.mcp.ai/api/pipedrive/add/an/installment/subscription` — Adds a new installment subscription.
  - body: { deal_id: integer, currency: string, payments: object[], update_deal_value?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/add/an/organization` — Set up a new pipedrive organization using custom fields with unique key hashes. retrieve `organizationfields` for configuration. check the linked tutorial for guidance.
- `POST https://api.mcp.ai/api/pipedrive/add/file` — Upload and link files to deals, people, organizations, activities, products, or leads in pipedrive. see the "adding a file" tutorial for details.
  - body: { file?: object, org_id?: integer, deal_id?: integer, lead_id?: object, person_id?: integer, product_id?: integer, activity_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/new/activity/type` — Adds a new activity type.
  - body: { name: string, color?: string, icon_key: string }
- `POST https://api.mcp.ai/api/pipedrive/add/or/update/role/setting` — Adds or updates the visibility setting for a role.
  - body: { id: integer, value: integer, setting_key: string }
- `POST https://api.mcp.ai/api/pipedrive/add/person/picture` — This service allows adding a photo to a person's profile, replacing any existing one. images must be square with a minimum size of 128 pixels and in gif, jpg, or png formats. they will be resized to 1
  - body: { id: integer, file?: object, crop_x?: integer, crop_y?: integer, crop_width?: integer, crop_height?: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/role/assignment` — Assigns a user to a role.
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/add/users/to/a/team` — Adds users to an existing team.
  - body: { id: integer, users: integer[] }
- `POST https://api.mcp.ai/api/pipedrive/archive/a/project` — Archives a project.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/attach/an/audio/file/to/the/call/log` — Adds an audio recording to the call log. that audio can be played by those who have access to the call log object.
  - body: { id: string, file?: object }
- `POST https://api.mcp.ai/api/pipedrive/cancel/a/recurring/subscription` — Cancels a recurring subscription.
  - body: { id: integer, end_date?: string }
- `POST https://api.mcp.ai/api/pipedrive/create/a/new/webhook` — Creates and returns details of a new webhook. trigger events combine `event action` and `event object`, like `*.*` for all events or `added.deal`, `deleted.persons` for specific actions. more info in 
  - body: { user_id?: integer, version?: string, event_action: string, event_object: string, http_auth_user?: string, subscription_url: string, http_auth_password?: string }
- `POST https://api.mcp.ai/api/pipedrive/create/a/remote/file/and/link/it/to/an/item` — Creates an empty file on google drive linked to an item. for details, refer to the pipedrive remote file adding tutorial.
  - body: { title: string, item_id: integer, file_type: string, item_type: string, remote_location: string }
- `POST https://api.mcp.ai/api/pipedrive/create/an/organization/relationship` — Creates and returns an organization relationship.
  - body: { type: string, org_id?: integer, rel_owner_org_id: integer, rel_linked_org_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/call/log` — Deletes a call log. if there is an audio recording attached to it, it will also be deleted. the related activity will not be removed by this request. if you want to remove the related activities, plea
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/channel` — The endpoint removes a messenger channel along with conversations and messages. requires messengers integration oauth and messaging app extension manifest.
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/comment/related/to/a/note` — Deletes a comment.
  - body: { id: integer, commentId: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/conversation` — Deletes an existing conversation. to use the endpoint, you need to have **messengers integration** oauth scope enabled and the messaging manifest ready for the [messaging app extension](https://pipedr
  - body: { channel__id: string, conversation__id: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/deal` — Marks a deal as deleted. after 30 days, the deal will be permanently deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/deal/field` — Marks a field as deleted. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/deleting-a-custom-field" target=" blank" rel="noopener noreferrer">deleting a custom fiel
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/file` — Marks a file as deleted. after 30 days, the file will be permanently deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/filter` — Marks a filter as deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/follower/from/a/deal` — Deletes a follower from a deal.
  - body: { id: integer, follower_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/follower/from/a/person` — Deletes a follower from a person.
  - body: { id: integer, follower_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/follower/from/a/product` — Deletes a follower from a product.
  - body: { id: integer, follower_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/follower/from/an/organization` — Deletes a follower from an organization. you can retrieve the `follower id` from the <a href="https://developers.pipedrive.com/docs/api/v1/organizations#getorganizationfollowers">list followers of an 
  - body: { id: integer, follower_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/lead` — Deletes a specific lead.
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/lead/label` — Deletes a specific lead label.
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/note` — Deletes a specific note.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/participant/from/a/deal` — Deletes a participant from a deal.
  - body: { id: integer, deal_participant_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/person` — Marks a person as deleted. after 30 days, the person will be permanently deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/person/field` — Marks a field as deleted. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/deleting-a-custom-field" target=" blank" rel="noopener noreferrer">deleting a custom fiel
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/pipeline` — Marks a pipeline as deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/product` — Marks a product as deleted. after 30 days, the product will be permanently deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/product/field` — Marks a product field as deleted. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/deleting-a-custom-field" target=" blank" rel="noopener noreferrer">deleting a cus
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/project` — Marks a project as deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/role` — Marks a role as deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/role/assignment` — Removes the assigned user from a role and adds to the default role.
  - body: { id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/stage` — Marks a stage as deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/subscription` — Marks an installment or a recurring subscription as deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/a/task` — Marks a task as deleted. if the task has subtasks then those will also be deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/an/activity` — Marks an activity as deleted. after 30 days, the activity will be permanently deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/an/activity/type` — Marks an activity type as deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/an/attached/product/from/a/deal` — Deletes a product attachment from a deal, using the `product attachment id`.
  - body: { id: integer, product_attachment_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/an/organization` — Marks an organization as deleted. after 30 days, the organization will be permanently deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/an/organization/field` — Marks a field as deleted. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/deleting-a-custom-field" target=" blank" rel="noopener noreferrer">deleting a custom fiel
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/an/organization/relationship` — Deletes an organization relationship and returns the deleted id.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/existing/goal` — Marks a goal as deleted.
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/existing/webhook` — Deletes the specified webhook.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/mail/thread` — Marks a mail thread as deleted.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/activities/in/bulk` — Marks multiple activities as deleted. after 30 days, the activities will be permanently deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/activity/types/in/bulk` — Marks multiple activity types as deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/deal/fields/in/bulk` — Marks multiple deal fields as deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/deals/in/bulk` — Marks multiple deals as deleted. after 30 days, the deals will be permanently deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/filters/in/bulk` — Marks multiple filters as deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/organization/fields/in/bulk` — Marks multiple fields as deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/organizations/in/bulk` — Marks multiple organizations as deleted. after 30 days, the organizations will be permanently deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/person/fields/in/bulk` — Marks multiple fields as deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/persons/in/bulk` — Marks multiple persons as deleted. after 30 days, the persons will be permanently deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/product/fields/in/bulk` — Marks multiple fields as deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/multiple/stages/in/bulk` — Marks multiple stages as deleted.
  - body: { ids: string }
- `POST https://api.mcp.ai/api/pipedrive/delete/person/picture` — Deletes a person’s picture.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/delete/users/from/a/team` — Deletes users from an existing team.
  - body: { id: integer, users: integer[] }
- `POST https://api.mcp.ai/api/pipedrive/download/one/file` — Initializes a file download.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/duplicate/deal` — Duplicates a deal.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/enumerate/accessible/users/for/lead` — Lists the users permitted to access a lead.
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/find/goals` — Query goal data by appending `{searchfield}={searchvalue}` to the url with dot-notation fields and values. include `is active` to filter by goal status and specify both `period.start` and `period.end`
  - body: { title?: string, is_active?: boolean, type__name?: string, period__end?: string, assignee__id?: integer, period__start?: string, assignee__type?: string, type__params__stage__id?: integer, expected__outcome__target?: integer, type__params__pipeline__id?: integer[], expected__outcome__currency__id?: integer, type__params__activity__type__id?: integer[], expected__outcome__tracking__metric?: string }
- `POST https://api.mcp.ai/api/pipedrive/find/subscription/by/deal` — Returns details of an installment or a recurring subscription by the deal id.
  - body: { dealId: integer }
- `POST https://api.mcp.ai/api/pipedrive/find/users/by/name` — Finds users by their name.
  - body: { term: string, search_by_email?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/a/single/team` — Returns data about a specific team.
  - body: { id: integer, skip_users?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/activities/assigned/to/a/particular/user` — Returns all activities assigned to a particular user.
  - body: { done?: integer, type?: string, limit?: integer, start?: integer, user_id?: integer, end_date?: string, filter_id?: integer, start_date?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/all/activities/beta` — This beta cursor-paginated endpoint returns all activities, accessible only to global admins, not regular users who get a 403 error. refer to pipedrive's documentation for pagination and global permis
  - body: { done?: boolean, type?: string, limit?: integer, since?: string, until?: string, cursor?: string, user_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/activity/fields` — Returns all activity fields.
- `POST https://api.mcp.ai/api/pipedrive/get/all/activity/types` — Returns all activity types.
- `POST https://api.mcp.ai/api/pipedrive/get/all/add/ons/for/a/single/company` — Returns the add-ons for a single company.
- `POST https://api.mcp.ai/api/pipedrive/get/all/call/logs/assigned/to/a/particular/user` — Returns all call logs assigned to a particular user.
  - body: { limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/comments/for/a/note` — Returns all comments associated with a note.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/deal/fields` — Returns data about all deal fields.
  - body: { limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/deals` — Returns all deals. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/getting-all-deals" target=" blank" rel="noopener noreferrer">getting all deals</a>.
  - body: { sort?: string, limit?: integer, start?: integer, status?: string, user_id?: integer, stage_id?: integer, filter_id?: integer, owned_by_you?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/deals/beta` — This endpoint returns all deals with cursor pagination (in beta). only global admins can access it; others get a 403 error. more info on pagination and permissions is available online.
  - body: { limit?: integer, since?: string, until?: string, cursor?: string, status?: string, user_id?: integer, stage_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/files` — Returns data about all files.
  - body: { sort?: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/filter/helpers` — The text provides links to documentation for adding or updating filters, and information on all supported filter helpers in an api. it encourages consulting a tutorial for more details on adding a fil
- `POST https://api.mcp.ai/api/pipedrive/get/all/filters` — Returns data about all filters.
  - body: { type?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/all/lead/labels` — Returns details of all lead labels. this endpoint does not support pagination and all labels are always returned.
- `POST https://api.mcp.ai/api/pipedrive/get/all/lead/sources` — Returns all lead sources. please note that the list of lead sources is fixed, it cannot be modified. all leads created through the pipedrive api will have a lead source `api` assigned.
- `POST https://api.mcp.ai/api/pipedrive/get/all/leads` — The api returns sorted leads by creation time, supporting pagination via `limit` and `start`. custom field values are included if set, mimicking the `deals` endpoint structure; unset fields are omitte
  - body: { sort?: string, limit?: integer, start?: integer, owner_id?: integer, filter_id?: integer, person_id?: integer, archived_status?: string, organization_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/mail/messages/of/mail/thread` — Returns all the mail messages inside a specified mail thread.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/note/fields` — Returns data about all note fields.
- `POST https://api.mcp.ai/api/pipedrive/get/all/notes` — Returns all notes.
  - body: { sort?: string, limit?: integer, start?: integer, org_id?: integer, deal_id?: integer, lead_id?: string, user_id?: integer, end_date?: string, person_id?: integer, start_date?: string, pinned_to_deal_flag?: integer, pinned_to_lead_flag?: integer, pinned_to_person_flag?: integer, pinned_to_organization_flag?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/organization/fields` — Returns data about all organization fields.
  - body: { limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/organizations` — Returns all organizations.
  - body: { sort?: string, limit?: integer, start?: integer, user_id?: integer, filter_id?: integer, first_char?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/all/organizations/beta` — This beta api endpoint lists all organizations with cursor pagination. only global admins have access; others get a 403 error. see docs for pagination and global permissions.
  - body: { limit?: integer, since?: string, until?: string, cursor?: string, owner_id?: integer, first_char?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/all/payments/of/a/subscription` — Returns all payments of an installment or recurring subscription.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/permission/sets` — Returns data about all permission sets.
  - body: { app?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/all/person/fields` — Returns data about all person fields.<br>if a company uses the [campaigns product](https://pipedrive.readme.io/docs/campaigns-in-pipedrive-api), then this endpoint will also return the `data.marketing
  - body: { limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/persons` — Returns all persons.
  - body: { sort?: string, limit?: integer, start?: integer, user_id?: integer, filter_id?: integer, first_char?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/all/persons/beta` — This beta endpoint returns all persons, using cursor pagination. only global admins have access; others get a 403 error. info on pagination and permissions is in the linked docs.
  - body: { limit?: integer, since?: string, until?: string, cursor?: string, owner_id?: integer, first_char?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/all/pipelines` — Returns data about all pipelines.
- `POST https://api.mcp.ai/api/pipedrive/get/all/product/fields` — Returns data about all product fields.
  - body: { limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/products` — Returns data about all products.
  - body: { ids?: integer[], limit?: integer, start?: integer, user_id?: integer, filter_id?: integer, first_char?: string, get_summary?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/get/all/project/boards` — Returns all projects boards that are not deleted.
- `POST https://api.mcp.ai/api/pipedrive/get/all/project/templates` — The endpoint retrieves all non-deleted project templates with cursor-based pagination. refer to the provided documentation link for more details on pagination.
  - body: { limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/all/projects` — Returns all projects. this is a cursor-paginated endpoint. for more information, please refer to our documentation on <a href="https://pipedrive.readme.io/docs/core-api-concepts-pagination" target=" b
  - body: { limit?: integer, cursor?: string, status?: string, phase_id?: integer, filter_id?: integer, include_archived?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/get/all/relationships/for/organization` — Gets all of the relationships for a supplied organization id.
  - body: { org_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/roles` — Returns all the roles within the company.
  - body: { limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/stages` — Returns data about all stages.
  - body: { limit?: integer, start?: integer, pipeline_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/supported/currencies` — Returns all supported currencies in given account which should be used when saving monetary values with other objects. the `code` parameter of the returning objects is the currency code according to i
  - body: { term?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/all/tasks` — Returns all tasks. this is a cursor-paginated endpoint. for more information, please refer to our documentation on <a href="https://pipedrive.readme.io/docs/core-api-concepts-pagination" target=" blan
  - body: { done?: integer, limit?: integer, cursor?: string, project_id?: integer, assignee_id?: integer, parent_task_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/teams` — Returns data about teams within the company.
  - body: { order_by?: string, skip_users?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/teams/of/a/user` — Returns data about all teams which have the specified user as a member.
  - body: { id: integer, order_by?: string, skip_users?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/user/connections` — Returns data about all connections for the authorized user.
- `POST https://api.mcp.ai/api/pipedrive/get/all/users` — Returns data about all users within the company.
- `POST https://api.mcp.ai/api/pipedrive/get/all/users/in/a/team` — Returns a list of all user ids within a team.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/all/webhooks` — Returns data about all the webhooks of a company.
- `POST https://api.mcp.ai/api/pipedrive/get/current/user/data` — Returns data about an authorized user within the company with bound company data: company id, company name, and domain. note that the `locale` property means 'date/number format' in the pipedrive acco
- `POST https://api.mcp.ai/api/pipedrive/get/deals/conversion/rates/in/pipeline` — Returns all stage-to-stage conversion and pipeline-to-close rates for the given time period.
  - body: { id: integer, user_id?: integer, end_date: string, start_date: string }
- `POST https://api.mcp.ai/api/pipedrive/get/deals/in/a/pipeline` — Lists deals in a specific pipeline across all its stages.
  - body: { id: integer, limit?: integer, start?: integer, user_id?: integer, everyone?: integer, stage_id?: integer, filter_id?: integer, get_summary?: integer, totals_convert_currency?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/deals/in/a/stage` — Lists deals in a specific stage.
  - body: { id: integer, limit?: integer, start?: integer, user_id?: integer, everyone?: integer, filter_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/deals/movements/in/pipeline` — Returns statistics for deals movements for the given time period.
  - body: { id: integer, user_id?: integer, end_date: string, start_date: string }
- `POST https://api.mcp.ai/api/pipedrive/get/deals/summary` — Returns a summary of all the deals.
  - body: { status?: string, user_id?: integer, stage_id?: integer, filter_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/deals/timeline` — Returns opened and won deals in time-based groups according to a specified dealfield, with examples of deals grouped by month over a 3-month period starting january 2012.
  - body: { amount: integer, user_id?: integer, interval: string, field_key: string, filter_id?: integer, start_date: string, pipeline_id?: integer, exclude_deals?: integer, totals_convert_currency?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/deals/where/a/product/is/attached/to` — Returns data about deals that have a product attached to it.
  - body: { id: integer, limit?: integer, start?: integer, status?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/a/board` — Returns the details of a specific project board.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/a/call/log` — Returns details of a specific call log.
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/a/deal` — Fetches specific deal details, including exclusive fields like deal age and pipeline stage duration. custom fields show up as hashes, which can be matched using the 'key' from dealfields. see the deal
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/a/person` — The text describes an api endpoint that returns detailed person information, including extra fields and custom fields as hashes. it also provides `data.marketing status` if the campaigns product is us
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/a/phase` — Returns the details of a specific project phase.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/a/project` — Returns the details of a specific project. also note that custom fields appear as long hashes in the resulting data. these hashes can be mapped against the `key` value of project fields.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/a/subscription` — Returns details of an installment or a recurring subscription.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/a/task` — Returns the details of a specific task.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/a/template` — Returns the details of a specific project template.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/an/activity` — Returns the details of a specific activity.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/details/of/an/organization` — Provides detailed information about an organization, including additional fields not shown when listing all organizations, and maps custom fields as long hashes to the 'key' value in organizationfield
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/mail/threads` — Returns mail threads in a specified folder ordered by the most recent message within.
  - body: { limit?: integer, start?: integer, folder: string }
- `POST https://api.mcp.ai/api/pipedrive/get/one/comment` — Returns the details of a comment.
  - body: { id: integer, commentId: string }
- `POST https://api.mcp.ai/api/pipedrive/get/one/deal/field` — Returns data about a specific deal field.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/file` — Returns data about a specific file.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/filter` — Returns data about a specific filter. note that this also returns the condition lines of the filter.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/lead` — Api returns specific lead details with custom field values in the deals format. unset custom fields are omitted. leads share custom fields with deals, not having a unique set.
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/get/one/mail/message` — Returns data about a specific mail message.
  - body: { id: integer, include_body?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/mail/thread` — Returns a specific mail thread.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/note` — Returns details about a specific note.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/organization/field` — Returns data about a specific organization field.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/organization/relationship` — Finds and returns an organization relationship from its id.
  - body: { id: integer, org_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/permission/set` — Returns data about a specific permission set.
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/get/one/person/field` — Returns data about a specific person field.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/pipeline` — Returns data about a specific pipeline. also returns the summary of the deals in this pipeline across its stages.
  - body: { id: integer, totals_convert_currency?: string }
- `POST https://api.mcp.ai/api/pipedrive/get/one/product` — Returns data about a specific product.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/product/field` — Returns data about a specific product field.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/role` — Returns the details of a specific role.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/stage` — Returns data about a specific stage.
  - body: { id: integer, everyone?: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/one/user` — Returns data about a specific user within the company.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/project/phases` — Returns all active project phases under a specific board.
  - body: { board_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/get/recents` — Returns data about all recent changes occurred after the given timestamp.
  - body: { items?: string, limit?: integer, start?: integer, since_timestamp: string }
- `POST https://api.mcp.ai/api/pipedrive/get/result/of/a/goal` — Gets the progress of a goal for the specified period.
  - body: { id: string, period__end: string, period__start: string }
- `POST https://api.mcp.ai/api/pipedrive/link/a/remote/file/to/an/item` — Links an existing remote file (`googledrive`) to the item you supply. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/adding-a-remote-file" target=" blank" rel="no
  - body: { item_id: integer, item_type: string, remote_id: string, remote_location: string }
- `POST https://api.mcp.ai/api/pipedrive/link/user/video/integration` — A video calling provider must call this endpoint after a user has installed the video calling app so that the new user's information is sent.
  - body: { user_id: integer, company_id: integer, user_provider_id: string, marketplace_client_id: string }
- `POST https://api.mcp.ai/api/pipedrive/list/activities/associated/with/a/deal` — Lists activities associated with a deal.
  - body: { id: integer, done?: integer, limit?: integer, start?: integer, exclude?: string }
- `POST https://api.mcp.ai/api/pipedrive/list/activities/associated/with/a/person` — Lists activities associated with a person.
  - body: { id: integer, done?: integer, limit?: integer, start?: integer, exclude?: string }
- `POST https://api.mcp.ai/api/pipedrive/list/activities/associated/with/an/organization` — Lists activities associated with an organization.
  - body: { id: integer, done?: integer, limit?: integer, start?: integer, exclude?: string }
- `POST https://api.mcp.ai/api/pipedrive/list/all/persons/associated/with/a/deal` — The endpoint lists every person linked to a deal, including primary contacts and participants, and provides a `data.marketing status` field for users of the campaigns product.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/deals/associated/with/a/person` — Lists deals associated with a person.
  - body: { id: integer, sort?: string, limit?: integer, start?: integer, status?: string }
- `POST https://api.mcp.ai/api/pipedrive/list/deals/associated/with/an/organization` — Lists deals associated with an organization.
  - body: { id: integer, sort?: string, limit?: integer, start?: integer, status?: string, only_primary_association?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/files/attached/to/a/deal` — Lists files associated with a deal.
  - body: { id: integer, sort?: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/files/attached/to/a/person` — Lists files associated with a person.
  - body: { id: integer, sort?: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/files/attached/to/a/product` — Lists files associated with a product.
  - body: { id: integer, sort?: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/files/attached/to/an/organization` — Lists files associated with an organization.
  - body: { id: integer, sort?: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/followers/of/a/deal` — Lists the followers of a deal.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/followers/of/a/person` — Lists the followers of a person.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/followers/of/a/product` — Lists the followers of a product.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/followers/of/a/user` — Lists the followers of a specific user.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/followers/of/an/organization` — Lists the followers of an organization.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/mail/messages/associated/with/a/deal` — Lists mail messages associated with a deal.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/mail/messages/associated/with/a/person` — Lists mail messages associated with a person.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/mail/messages/associated/with/an/organization` — Lists mail messages associated with an organization.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/participants/of/a/deal` — Lists the participants associated with a deal.<br>if a company uses the [campaigns product](https://pipedrive.readme.io/docs/campaigns-in-pipedrive-api), then this endpoint will also return the `data.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/permission/set/assignments` — Returns the list of assignments for a permission set.
  - body: { id: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/permitted/users` — Lists the users permitted to access a deal.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/person/access/users` — List users permitted to access a person.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/persons/of/an/organization` — Lists persons associated with an organization.<br>if a company uses the [campaigns product](https://pipedrive.readme.io/docs/campaigns-in-pipedrive-api), then this endpoint will also return the `data.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/pipeline/visibility/for/a/role` — Returns a list of visible or hidden pipeline ids by role. see the "visibility groups article" for details on pipeline visibility.
  - body: { id: integer, visible?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/list/product/permitted/users` — Lists users permitted to access a product.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/products/associated/with/a/person` — Lists products associated with a person.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/products/attached/to/a/deal` — Lists products attached to a deal.
  - body: { id: integer, limit?: integer, start?: integer, include_product_data?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/role/assignments` — Returns all users assigned to a role.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/role/settings` — Returns the visibility settings of a specific role.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/settings/of/an/authorized/user` — Lists the settings of an authorized user. example response contains a shortened list of settings.
- `POST https://api.mcp.ai/api/pipedrive/list/updates/about/a/deal` — Lists updates about a deal.
  - body: { id: integer, items?: string, limit?: integer, start?: integer, all_changes?: string }
- `POST https://api.mcp.ai/api/pipedrive/list/updates/about/a/person` — Lists updates about a person.<br>if a company uses the [campaigns product](https://pipedrive.readme.io/docs/campaigns-in-pipedrive-api), then this endpoint's response will also include updates for the
  - body: { id: integer, items?: string, limit?: integer, start?: integer, all_changes?: string }
- `POST https://api.mcp.ai/api/pipedrive/list/updates/about/an/organization` — Lists updates about an organization.
  - body: { id: integer, items?: string, limit?: integer, start?: integer, all_changes?: string }
- `POST https://api.mcp.ai/api/pipedrive/list/updates/about/participants/of/a/deal` — This endpoint provides cursor-paginated updates on deal participants. for pagination details, see the pipedrive documentation.
  - body: { id: integer, limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/pipedrive/list/user/permissions` — Lists aggregated permissions over all assigned permission sets for a user.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/list/user/role/settings` — Lists the settings of user's assigned role.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/merge/two/deals` — Merges a deal with another deal. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/merging-two-deals" target=" blank" rel="noopener noreferrer">merging two deals</a>
  - body: { id: integer, merge_with_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/merge/two/organizations` — Merges an organization with another organization. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/merging-two-organizations" target=" blank" rel="noopener noreferr
  - body: { id: integer, merge_with_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/merge/two/persons` — Merges a person with another person. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/merging-two-persons" target=" blank" rel="noopener noreferrer">merging two per
  - body: { id: integer, merge_with_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/organization/accessible/user/list` — List users permitted to access an organization.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/perform/a/search/from/multiple/item/types` — Performs a search from your choice of item types and fields.
  - body: { term: string, limit?: integer, start?: integer, fields?: string, item_types?: string, exact_match?: boolean, include_fields?: string, search_for_related_items?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/pipedrive/list/user/role/assignments` — Lists role assignments for a user.
  - body: { id: integer, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/pipedrive/receives/an/incoming/message` — Adds a message to a conversation. to use the endpoint, you need to have **messengers integration** oauth scope enabled and the messaging manifest ready for the [messaging app extension](https://pipedr
  - body: { id: string, status: string, message: string, reply_by?: string, sender_id: string, channel_id: string, created_at: string, attachments?: object[], conversation_id: string, conversation_link?: string }
- `POST https://api.mcp.ai/api/pipedrive/refreshing/the/tokens` — Access tokens expire after the time specified in `expires in`. to continue accessing the api, use the `refresh token` to obtain a new access token.
  - body: { grant_type?: string, refresh_token?: string }
- `POST https://api.mcp.ai/api/pipedrive/requesting/authorization` — Authorize a user by redirecting them to the pipedrive oauth authorization page and request their permissions to act on their behalf. this step is necessary to implement only when you allow app install
  - body: { state?: string, client_id: string, redirect_uri: string }
- `POST https://api.mcp.ai/api/pipedrive/returns/project/activities` — Returns activities linked to a specific project.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/returns/project/groups` — Returns all active groups under a specific project.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/returns/project/plan` — Returns information about items in a project plan. items consists of tasks and activities and are linked to specific project phase and group.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/returns/project/tasks` — Returns tasks linked to a specific project.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/search/deals` — This api endpoint searches deals by title, notes, and custom fields, filters results by person or organization id, and is a specific use case of /v1/itemsearch with limited oauth scope.
  - body: { term: string, limit?: integer, start?: integer, fields?: string, status?: string, person_id?: integer, exact_match?: boolean, include_fields?: string, organization_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/search/item/by/field` — Performs a search from the values of a specific field. results can either be the distinct values of the field (useful for searching autocomplete field values), or the ids of actual items (deals, leads
  - body: { term: string, limit?: integer, start?: integer, field_key: string, field_type: string, exact_match?: boolean, return_item_ids?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/search/leads` — Endpoint searches leads by title, notes, custom fields, with options to filter by person and organization ids, and is a more specific use of the /v1/itemsearch with limited oauth scope.
  - body: { term: string, limit?: integer, start?: integer, fields?: string, person_id?: integer, exact_match?: boolean, include_fields?: string, organization_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/search/organizations` — Searches all organizations by name, address, notes and/or custom fields. this endpoint is a wrapper of <a href="https://developers.pipedrive.com/docs/api/v1/itemsearch#searchitem">/v1/itemsearch</a> w
  - body: { term: string, limit?: integer, start?: integer, fields?: string, exact_match?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/search/persons` — This endpoint searches for individuals by various identifiers and is a specific use case of /v1/itemsearch with limited oauth scope, allowing results filtering by organization id.
  - body: { term: string, limit?: integer, start?: integer, fields?: string, exact_match?: boolean, include_fields?: string, organization_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/search/products` — Searches all products by name, code and/or custom fields. this endpoint is a wrapper of <a href="https://developers.pipedrive.com/docs/api/v1/itemsearch#searchitem">/v1/itemsearch</a> with a narrower 
  - body: { term: string, limit?: integer, start?: integer, fields?: string, exact_match?: boolean, include_fields?: string }
- `POST https://api.mcp.ai/api/pipedrive/unlink/user/from/video/call/integration` — A video calling provider must call this endpoint to remove the link between a user and the installed video calling app.
  - body: { id: string }
- `POST https://api.mcp.ai/api/pipedrive/update/a/comment/related/to/a/note` — Updates a comment related to a note.
  - body: { id: integer, content: string, commentId: string }
- `POST https://api.mcp.ai/api/pipedrive/update/a/deal` — Updates the properties of a deal. for more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/updating-a-deal" target=" blank" rel="noopener noreferrer">updating a deal</a>.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/a/deal/field` — Updates a deal field. for more information, see the tutorial for <a href=" https://pipedrive.readme.io/docs/updating-custom-field-value " target=" blank" rel="noopener noreferrer">updating custom fiel
  - body: { id: integer, name?: string, options?: object[], add_visible_flag?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/update/a/lead` — Updating lead properties modifies only specified fields; use `null` to unset. custom field data matches `deals`. unset fields are omitted. leads share deals' custom fields. for examples, refer to the 
  - body: { id: string, title?: string, owner_id?: integer, was_seen?: boolean, label_ids?: string[], person_id?: integer, is_archived?: boolean, value__amount?: integer, organization_id?: integer, value__currency?: string, expected_close_date?: string }
- `POST https://api.mcp.ai/api/pipedrive/update/a/lead/label` — Updates one or more properties of a lead label. only properties included in the request will be updated.
  - body: { id: string, name?: string, color?: string }
- `POST https://api.mcp.ai/api/pipedrive/update/a/note` — Updates a note.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/a/person` — Modifies a person’s details in pipedrive. see the linked tutorial for guidance. if utilizing campaigns, the endpoint also handles `data.marketing status`.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/a/person/field` — Updates a person field. for more information, see the tutorial for <a href=" https://pipedrive.readme.io/docs/updating-custom-field-value " target=" blank" rel="noopener noreferrer">updating custom fi
  - body: { id: integer, name?: string, options?: object[], add_visible_flag?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/update/a/pipeline` — Updates the properties of a pipeline.
  - body: { id: integer, name?: string, order_nr?: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/a/product` — Updates product data.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/a/product/field` — Updates a product field. for more information, see the tutorial for <a href=" https://pipedrive.readme.io/docs/updating-custom-field-value " target=" blank" rel="noopener noreferrer">updating custom f
  - body: { id: integer, name?: string, options?: object[] }
- `POST https://api.mcp.ai/api/pipedrive/update/a/project` — Updates a project.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/a/recurring/subscription` — Updates a recurring subscription.
  - body: { id: integer, payments?: object[], description?: string, cycle_amount?: integer, effective_date: string, update_deal_value?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/update/a/task` — Updates a task.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/a/team` — Updates an existing team and returns the updated object.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/activity/in/project/plan` — Updates an activity phase or group in a project.
  - body: { id: integer, group_id?: integer, phase_id?: integer, activityId: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/an/activity` — Updates an activity. includes `more activities scheduled in context` property in response's `additional data` which indicates whether there are more undone activities scheduled with the same deal, per
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/an/activity/type` — Updates an activity type.
  - body: { id: integer, name?: string, color?: string, icon_key?: string, order_nr?: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/an/installment/subscription` — Updates an installment subscription.
  - body: { id: integer, payments: object[], update_deal_value?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/update/an/organization` — Updates the properties of an organization.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/an/organization/field` — Updates an organization field. for more information, see the tutorial for <a href=" https://pipedrive.readme.io/docs/updating-custom-field-value " target=" blank" rel="noopener noreferrer">updating cu
  - body: { id: integer, name?: string, options?: object[], add_visible_flag?: boolean }
- `POST https://api.mcp.ai/api/pipedrive/update/an/organization/relationship` — Updates and returns an organization relationship.
  - body: { id: integer, type?: string, org_id?: integer, rel_owner_org_id?: integer, rel_linked_org_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/existing/goal` — Updates an existing goal.
  - body: { id: string, title?: string, interval?: string }
- `POST https://api.mcp.ai/api/pipedrive/update/file/details` — Updates the properties of a file.
  - body: { id: integer, name?: string, description?: string }
- `POST https://api.mcp.ai/api/pipedrive/update/filter` — Updates an existing filter.
  - body: { id: integer, name?: string }
- `POST https://api.mcp.ai/api/pipedrive/update/mail/thread/details` — Updates the properties of a mail thread.
  - body: { id: integer, deal_id?: integer, lead_id?: string }
- `POST https://api.mcp.ai/api/pipedrive/update/pipeline/visibility/for/a/role` — Updates pipeline visibility settings for different roles. for details, see the pipedrive visibility groups article.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/role/details` — Updates the parent role and/or the name of a specific role.
  - body: { id: integer, name?: string, parent_role_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/stage/details` — Updates the properties of a stage.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/task/in/project/plan` — Updates a task phase or group in a project.
  - body: { id: integer, taskId: integer, group_id?: integer, phase_id?: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/the/product/attached/to/a/deal` — Updates the details of the product that has been attached to a deal.
  - body: { id: integer, tax?: integer, comments?: string, discount?: integer, duration?: integer, quantity?: integer, item_price?: integer, product_id?: integer, tax_method?: string, enabled_flag?: boolean, discount_type?: string, product_variation_id?: integer, product_attachment_id: integer }
- `POST https://api.mcp.ai/api/pipedrive/update/user/details` — Updates the properties of a user. currently, only `active flag` can be updated.
  - body: { id: integer, active_flag: boolean }

## More
- Page: https://mcp.ai/pipedrive
- Agent spec (llms.txt): https://mcp.ai/pipedrive/llms.txt
- Postman collection: https://mcp.ai/pipedrive/postman.json