> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipedrive

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

![Pipedrive logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/pipedrive.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=fe3cbbd7369a391e393d0e23c91eed75)

* **Category:** crm
* **Auth:** OAUTH2, API\_KEY
* **Composio-managed OAuth available?** No
* **Tools:** 406
* **Triggers:** 3
* **Slug:** `PIPEDRIVE`
* **Version:** 20261101\_00

## Frequently Asked Questions

> [accordion] How do I set up custom OAuth credentials for Pipedrive?
>
> For a step-by-step guide on creating and configuring your own Pipedrive OAuth credentials with Composio, see [How to create OAuth credentials for Pipedrive](https://composio.dev/auth/pipedrive).

> [accordion] Why am I seeing "App not found" when connecting Pipedrive?
>
> Pipedrive usually shows "App not found" when the OAuth app used for the connection is not approved or available for that user/workspace.
>
> If you are using managed Pipedrive OAuth, this means the managed OAuth app is still under Pipedrive review/verification. If you are using your own Pipedrive OAuth app, check the app's approval/verification status in Pipedrive and make sure the user is authorizing the same app configured in the auth config. After the app is approved or corrected, start a fresh connection.

> [accordion] How should I connect with my own Pipedrive OAuth app?
>
> Create the OAuth app in Pipedrive Developer Hub, then use that app's client ID and client secret in a Pipedrive custom OAuth auth config.
>
> Do not start the user connection by clicking **Install and Test** inside Pipedrive's OAuth app settings. That button starts Pipedrive's own test/install flow, not the Composio connection flow, and can send the user to the callback URL without the Composio auth config context.
>
> After saving the custom auth config, start the connection from Composio and enter the Pipedrive subdomain when prompted. If Pipedrive shows "App not found", verify that the client ID and secret match the same Pipedrive OAuth app, that the app is approved/available for the user, and that the redirect URI matches the Pipedrive auth setup guide.

## Tools

> [accordion] Add new activity type
>
> **Slug:** `PIPEDRIVE_ADD_ACTIVITY_TYPE`
>
> Adds a new activity type.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the activity type
>
> **color** `string`
>
> A designated color for the activity type in 6-character HEX format (e.g. `FFFFFF` for white, `000000` for black)
>
> **icon\_key** `string ("task" | "email" | "meeting" | "deadline" | "call" | "lunch" | "calendar" | "downarrow" | "document" | "smartphone" | "camera" | "scissors" | "cogs" | "bubble" | "uparrow" | "checkbox" | "signpost" | "shuffle" | "addressbook" | "linegraph" | "picture" | "car" | "world" | "search" | "clip" | "sound" | "brush" | "key" | "padlock" | "pricetag" | "suitcase" | "finish" | "plane" | "loop" | "wifi" | "truck" | "cart" | "bulb" | "bell" | "presentation")` *required*
>
> Icon graphic to use for representing this activity type
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a deal
>
> **Slug:** `PIPEDRIVE_ADD_A_DEAL`
>
> Creates a Pipedrive deal with a title and optional properties such as owner, linked person or organization, pipeline, stage, value, and status. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use POST /api/v2/deals instead.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> The deal title
>
> **value** `number`
>
> Monetary value of the deal
>
> **org\_id** `integer`
>
> ID of the organization
>
> **status** `string`
>
> Status of the deal (open, won, lost). Defaults to open
>
> **user\_id** `integer`
>
> ID of the user who will be marked as owner of this deal
>
> **currency** `string`
>
> Currency for the deal value (3-letter ISO code)
>
> **stage\_id** `integer`
>
> Stage ID for the deal
>
> **person\_id** `integer`
>
> ID of the person this deal is linked to
>
> **visible\_to** `integer`
>
> Visibility of the deal (owner, entire company etc)
>
> **pipeline\_id** `integer`
>
> Pipeline ID for the deal
>
> **probability** `number`
>
> Success probability percentage (0-100)
>
> **expected\_close\_date** `string`
>
> Expected close date in format YYYY-MM-DD
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add an activity
>
> **Slug:** `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/adding-an-activity).
>
> #### Input Parameters
>
> **done** `integer`
>
> Whether the activity is done (0 = not done, 1 = done)
>
> **note** `string`
>
> Note/description of the activity
>
> **type** `string` *required*
>
> The type of the activity (matches ActivityTypes.key\_string)
>
> **org\_id** `string`
>
> ID of the linked organization
>
> **deal\_id** `string`
>
> ID of the linked deal (integer or numeric string)
>
> **lead\_id** `string`
>
> ID of the linked lead (UUID string)
>
> **subject** `string` *required*
>
> The subject/title of the activity
>
> **user\_id** `integer`
>
> ID of the user who owns the activity
>
> **due\_date** `string`
>
> Due date of the activity (YYYY-MM-DD)
>
> **due\_time** `string`
>
> Due time of the activity (HH:MM)
>
> **duration** `string`
>
> Duration of the activity (e.g., 00:30)
>
> **location** `string`
>
> Location/address of the activity
>
> **attendees** `array`
>
> Attendees of the activity (contacts or external emails)
>
> **busy\_flag** `boolean`
>
> Whether the activity marks the assignee as busy
>
> **person\_id** `integer`
>
> ID of the linked person
>
> **project\_id** `integer`
>
> ID of the linked project
>
> **participants** `array`
>
> Participants of the activity
>
> **public\_description** `string`
>
> Public description synced to external calendar
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add an organization
>
> **Slug:** `PIPEDRIVE_ADD_AN_ORGANIZATION`
>
> Creates a new organization in Pipedrive with a required name and optional owner and visibility settings.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the organization to create (required). This is typically a company or business name such as 'Acme Corp' or 'Tech Solutions Inc.'
>
> **owner\_id** `integer`
>
> Owner user ID
>
> **visible\_to** `integer`
>
> Visibility (e.g., 1=owner only, 3=entire company)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a note (Deprecated)
>
> **Slug:** `PIPEDRIVE_ADD_A_NOTE`
>
> DEPRECATED: Use PIPEDRIVE\_PIPEDRIVE\_ADD\_NOTE instead. 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.
>
> #### Input Parameters
>
> **org\_id** `integer`
>
> The ID of the organization this note will be attached to. Required unless one of (deal\_id/person\_id/lead\_id/project\_id) is specified.
>
> **content** `string` *required*
>
> The content of the note in HTML format. Subject to sanitization on the back-end.
>
> **deal\_id** `integer`
>
> The ID of the deal the note will be attached to. Required unless one of (lead\_id/person\_id/org\_id/project\_id) is specified.
>
> **lead\_id** `string`
>
> The ID of the lead the note will be attached to (UUID format). Required unless one of (deal\_id/person\_id/org\_id/project\_id) is specified.
>
> **add\_time** `string`
>
> The optional creation date & time of the note in UTC. Format: YYYY-MM-DD HH:MM:SS
>
> **person\_id** `integer`
>
> The ID of the person this note will be attached to. Required unless one of (deal\_id/lead\_id/org\_id/project\_id) is specified.
>
> **project\_id** `integer`
>
> The ID of the project the note will be attached to. Required unless one of (deal\_id/person\_id/org\_id/lead\_id) is specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a person
>
> **Slug:** `PIPEDRIVE_ADD_A_PERSON`
>
> Adds a new contact in Pipedrive. For Campaigns users, it can also set the marketing status.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the person. REQUIRED by Pipedrive API.
>
> **email** `array`
>
> List of email objects: \{ value: string, label?: string, primary?: bool }
>
> **phone** `array`
>
> List of phone objects: \{ value: string, label?: string, primary?: bool }
>
> **org\_id** `integer`
>
> ID of the linked organization
>
> **add\_time** `string`
>
> Creation time (RFC 3339)
>
> **owner\_id** `integer`
>
> ID of the user who will be marked as the owner of this person
>
> **label\_ids** `array`
>
> IDs of labels to assign to the person
>
> **visible\_to** `integer`
>
> Visibility of the person (e.g., 1=owner only, 3=entire company)
>
> **update\_time** `string`
>
> Last update time (RFC 3339)
>
> **marketing\_status** `string`
>
> Marketing status (no\_consent, unsubscribed, subscribed, archived). Field is available only when Campaigns is enabled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a call log
>
> **Slug:** `PIPEDRIVE_ADD_CALL_LOG`
>
> Adds a new call log.
>
> #### Input Parameters
>
> **note** `string`
>
> The note for the call log in HTML format
>
> **org\_id** `integer`
>
> The ID of the organization this call is associated with
>
> **deal\_id** `integer`
>
> The ID of the deal this call is associated with. A call log can be associated with either a deal or a lead, but not both at once.
>
> **lead\_id** `string`
>
> The ID of the lead in the UUID format this call is associated with. A call log can be associated with either a deal or a lead, but not both at once.
>
> **outcome** `string ("connected" | "no_answer" | "left_message" | "left_voicemail" | "wrong_number" | "busy")` *required*
>
> Describes the outcome of the call
>
> **subject** `string`
>
> The name of the activity this call is attached to
>
> **user\_id** `integer`
>
> The ID of the owner of the call log. Please note that a user without account settings access cannot create call logs for other users.
>
> **duration** `string`
>
> The duration of the call in seconds
>
> **end\_time** `string` *required*
>
> The date and time of the end of the call in UTC. Format: YYYY-MM-DD HH:MM:SS.
>
> **person\_id** `integer`
>
> The ID of the person this call is associated with
>
> **start\_time** `string` *required*
>
> The date and time of the start of the call in UTC. Format: YYYY-MM-DD HH:MM:SS.
>
> **activity\_id** `integer`
>
> If specified, this activity will be converted into a call log, with the information provided. When this field is used, you don"t need to specify `deal_id`, `person_id` or `org_id`, as they will be ignored in favor of the values already available in the activity. The `activity_id` must refer to a `call` type activity.
>
> **to\_phone\_number** `string` *required*
>
> The number called
>
> **from\_phone\_number** `string`
>
> The number that made the call
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Call Log Audio File
>
> **Slug:** `PIPEDRIVE_ADD_CALL_LOG_AUDIO_FILE`
>
> Tool to attach an audio recording to an existing call log in Pipedrive. Use when you need to add audio evidence to a call log. Only one recording per call log is allowed.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the call log to attach the recording to. This is the ID received when you create the call log.
>
> **file** `object` *required*
>
> Audio file to upload. FileType object with 'name' (audio filename e.g., 'recording.mp3', 'audio.wav') and 'content' (base64-encoded audio data). Must be an HTML5-compatible audio format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a channel
>
> **Slug:** `PIPEDRIVE_ADD_CHANNEL`
>
> Registers a messaging channel for an admin, using the Messengers integration OAuth scope and a prepared Messaging app extension manifest. The Channels API is deprecated and its availability is no longer assured.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the channel
>
> **avatar\_url** `string`
>
> The URL for an icon that represents your channel
>
> **provider\_type** `string ("facebook" | "whatsapp" | "other")`
>
> It controls the icons (like the icon next to the conversation)
>
> **template\_support** `boolean`
>
> If true, enables templates logic on UI. Requires getTemplates endpoint implemented. Find out more [here](https://pipedrive.readme.io/docs/implementing-messaging-app-extension).
>
> **provider\_channel\_id** `string` *required*
>
> The channel ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add discount to deal
>
> **Slug:** `PIPEDRIVE_ADD_DEAL_DISCOUNT`
>
> Tool to add a discount to a deal in Pipedrive. Use when you need to apply a percentage-based or fixed amount discount to an existing deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal to add the discount to
>
> **type** `string ("percentage" | "amount")` *required*
>
> Determines whether the discount is applied as a percentage or a fixed amount
>
> **amount** `number` *required*
>
> The discount amount. Must be a positive number (excluding 0).
>
> **description** `string` *required*
>
> The name of the discount
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new deal field
>
> **Slug:** `PIPEDRIVE_ADD_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](https://pipedrive.readme.io/docs/adding-a-new-custom-field)" target="\_blank" rel="noopener noreferrer">adding a new custom field\</a>.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the field
>
> **options** `array`
>
> When `field_type` is either `set` or `enum`, possible options must be supplied \[\{"label":"red"}, \{"label":"blue"}, \{"label":"lilac"}]
>
> **field\_type** `string ("varchar" | "varchar_auto" | "text" | "double" | "monetary" | "date" | "set" | "enum" | "user" | "org" | "people" | "phone" | "time" | "timerange" | "daterange" | "address")` *required*
>
> The type of the field. Supported values: varchar, varchar\_auto, text, double, monetary, date, set, enum, user, org, people, phone, time, timerange, daterange, address
>
> **add\_visible\_flag** `boolean`
>
> Whether the field is available in "add new" modal or not (both in web and mobile app)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add deal field options
>
> **Slug:** `PIPEDRIVE_ADD_DEALFIELDS_OPTIONS`
>
> Tool to add new options to a deal custom field atomically. Use when you need to add options to enum or set type deal fields.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to add. At least one option is required. Each option must have a label. This is an atomic operation - either all options are added or none.
>
> **field\_code** `string` *required*
>
> The unique code identifying the deal field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a follower to a deal
>
> **Slug:** `PIPEDRIVE_ADD_DEAL_FOLLOWER`
>
> Adds a follower to a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **user\_id** `integer` *required*
>
> The ID of the user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a participant to a deal
>
> **Slug:** `PIPEDRIVE_ADD_DEAL_PARTICIPANT`
>
> Adds a participant to a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **person\_id** `integer` *required*
>
> The ID of the person
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add product to deal
>
> **Slug:** `PIPEDRIVE_ADD_DEAL_PRODUCT`
>
> Tool to add a product to a deal in Pipedrive. Use when you need to attach a product to an existing deal with custom pricing, quantity, duration, discount, and tax settings.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal to which the product will be added
>
> **tax** `number`
>
> The product tax percentage
>
> **comments** `string`
>
> Notes or comments about the product
>
> **discount** `number`
>
> The value of the discount (use with discount\_type to specify if amount or percentage)
>
> **duration** `number`
>
> Duration value for the product
>
> **quantity** `number` *required*
>
> The quantity of the product to add
>
> **is\_enabled** `boolean`
>
> Whether this product is enabled for the deal (cannot be disabled if deal has installments and product is the last enabled one)
>
> **item\_price** `number` *required*
>
> The price value at which this product is added to the deal
>
> **product\_id** `integer` *required*
>
> The ID of the product to attach to the deal
>
> **tax\_method** `string`
>
> Tax application method: 'exclusive' (tax not included in price), 'inclusive' (tax already included in price), or 'none' (no tax). Defaults to user setting. Changing this affects all products attached to the deal
>
> **discount\_type** `string`
>
> Specifies whether discount is a 'percentage' or 'amount'
>
> **billing\_frequency** `string`
>
> How often the product is billed (Growth+ plans only): 'one-time', 'annually', 'semi-annually', 'quarterly', 'monthly', or 'weekly'
>
> **billing\_start\_date** `string`
>
> Billing start date in YYYY-MM-DD format (within ±10 years from today)
>
> **discount\_percentage** `number`
>
> Discount percentage (legacy parameter, use discount + discount\_type instead)
>
> **product\_variation\_id** `integer`
>
> The ID of the product variation if applicable
>
> **billing\_frequency\_cycles** `integer`
>
> Number of times the billing frequency repeats (must be positive integer, maximum 208)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk add products to deal
>
> **Slug:** `PIPEDRIVE_ADD_DEAL_PRODUCTS`
>
> Tool to bulk add products to a Pipedrive deal. Use when attaching multiple products simultaneously, with maximum 100 products per request.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal to which products will be attached
>
> **data** `array` *required*
>
> Array of product objects to attach to the deal. Maximum 100 products per request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add file
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **file** `object`
>
> File to upload (base64 content supported)
>
> **org\_id** `integer`
>
> Org Id
>
> **deal\_id** `integer`
>
> Deal Id
>
> **lead\_id** `string`
>
> Lead Id (UUID)
>
> **person\_id** `integer`
>
> Person Id
>
> **product\_id** `integer`
>
> Product Id
>
> **activity\_id** `integer`
>
> Activity Id
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new filter
>
> **Slug:** `PIPEDRIVE_ADD_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.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the filter
>
> **type** `string` *required*
>
> The type of the filter. One of: deals, leads, org, people, products, activity, projects
>
> **conditions** `object` *required*
>
> Filter conditions object. Must follow structure with a top-level 'and' group containing two groups (one 'and' and one 'or').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new goal
>
> **Slug:** `PIPEDRIVE_ADD_GOAL`
>
> Adds a new goal. Along with adding a new goal, a report is created to track the progress of your goal.
>
> #### Input Parameters
>
> **type** `object` *required*
>
> The type of the goal and its parameters
>
> **title** `string`
>
> The title of the goal
>
> **assignee** `object` *required*
>
> The assignee of the goal
>
> **duration** `object` *required*
>
> Goal active duration
>
> **interval** `string ("weekly" | "monthly" | "quarterly" | "yearly")` *required*
>
> The interval of the goal
>
> **expected\_outcome** `object` *required*
>
> Expected outcome configuration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Receives an incoming message
>
> **Slug:** `PIPEDRIVE_ADD_INCOMING_MESSAGE`
>
> Submits an incoming message to a conversation using the Channels API, requiring the Messengers integration OAuth scope and a Messaging app extension manifest. The endpoint is deprecated and was guaranteed accessible only until February 1, 2026.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the message
>
> **status** `string ("sent" | "delivered" | "read" | "failed")` *required*
>
> The status of the message
>
> **message** `string` *required*
>
> The body of the message
>
> **reply\_by** `string`
>
> The date and time when the message can no longer receive a reply, in UTC. Format: YYYY-MM-DD HH:MM
>
> **sender\_id** `string` *required*
>
> The ID of the provider"s user that sent the message
>
> **channel\_id** `string` *required*
>
> The channel ID as in the provider
>
> **created\_at** `string` *required*
>
> The date and time when the message was created in the provider, in UTC. Format: YYYY-MM-DD HH:MM
>
> **attachments** `array`
>
> The list of attachments available in the message
>
> **conversation\_id** `string` *required*
>
> The ID of the conversation
>
> **conversation\_link** `string`
>
> A URL that can open the conversation in the provider"s side
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add an installment subscription
>
> **Slug:** `PIPEDRIVE_ADD_INSTALLMENT_SUBSCRIPTION`
>
> Adds an installment subscription for a deal using the supplied payment schedule. Individual deal installments may be created instead; creation is not atomic, so only some payments may be created, and the result may contain only the first created installment.
>
> #### Input Parameters
>
> **deal\_id** `integer` *required*
>
> The ID of the deal this installment subscription is associated with
>
> **currency** `string` *required*
>
> The currency of the installment subscription. Accepts a 3-character currency code.
>
> **payments** `array` *required*
>
> Array of payments. It requires a minimum structure as follows: \[\{ amount:SUM, description:DESCRIPTION, due\_at:PAYMENT\_DATE }]. Replace SUM with a payment amount, DESCRIPTION with an explanation string, PAYMENT\_DATE with a date (format YYYY-MM-DD).
>
> **update\_deal\_value** `boolean`
>
> Indicates that the deal value must be set to the installment subscription"s total value
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a lead
>
> **Slug:** `PIPEDRIVE_ADD_LEAD`
>
> Adds a lead linked to a person or organization and tagged with an API source.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> The name of the lead
>
> **owner\_id** `integer`
>
> The ID of the user which will be the owner of the created lead. If not provided, the user making the request will be used.
>
> **was\_seen** `boolean`
>
> A flag indicating whether the lead was seen by someone in the Pipedrive UI
>
> **label\_ids** `array`
>
> The IDs of the lead labels which will be associated with the lead
>
> **person\_id** `integer`
>
> REQUIRED if organization\_id is not provided. The ID of a person which this lead will be linked to. If the person does not exist yet, it needs to be created first. At least one of person\_id or organization\_id must be set.
>
> **value\_\_amount** `integer`
>
> Amount
>
> **organization\_id** `integer`
>
> REQUIRED if person\_id is not provided. The ID of an organization which this lead will be linked to. If the organization does not exist yet, it needs to be created first. At least one of person\_id or organization\_id must be set.
>
> **value\_\_currency** `string`
>
> Currency
>
> **expected\_close\_date** `string`
>
> The date of when the deal which will be created from the lead is expected to be closed. In ISO 8601 format: YYYY-MM-DD.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a lead label
>
> **Slug:** `PIPEDRIVE_ADD_LEAD_LABEL`
>
> Creates a lead label.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the lead label
>
> **color** `string ("green" | "blue" | "red" | "yellow" | "purple" | "gray" | "brown" | "dark-gray" | "orange" | "pink")` *required*
>
> The color of the label. Only a subset of colors can be used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Note
>
> **Slug:** `PIPEDRIVE_ADD_NOTE`
>
> Tool to add a note to a deal, person, organization, lead, or project in Pipedrive. Use when you need to create a note attached to an entity. At least one entity ID (lead\_id, deal\_id, person\_id, org\_id, or project\_id) must be provided.
>
> #### Input Parameters
>
> **org\_id** `integer`
>
> The ID of the organization to attach the note to. At least one of lead\_id, deal\_id, person\_id, org\_id, or project\_id must be provided.
>
> **content** `string` *required*
>
> The content of the note in HTML format. Subject to sanitization on the back-end.
>
> **deal\_id** `integer`
>
> The ID of the deal to attach the note to. At least one of lead\_id, deal\_id, person\_id, org\_id, or project\_id must be provided.
>
> **lead\_id** `string`
>
> The ID of the lead to attach the note to (UUID format). At least one of lead\_id, deal\_id, person\_id, org\_id, or project\_id must be provided.
>
> **user\_id** `integer`
>
> The ID of the user who will be marked as the author of the note. Only admins can change this.
>
> **add\_time** `string`
>
> The creation timestamp for the note in UTC. Format: YYYY-MM-DD HH:MM:SS
>
> **person\_id** `integer`
>
> The ID of the person to attach the note to. At least one of lead\_id, deal\_id, person\_id, org\_id, or project\_id must be provided.
>
> **project\_id** `integer`
>
> The ID of the project to attach the note to. At least one of lead\_id, deal\_id, person\_id, org\_id, or project\_id must be provided.
>
> **pinned\_to\_deal\_flag** `integer ("0" | "1")`
>
> If set to 1, the note will be pinned to the deal. 0 or omit to not pin.
>
> **pinned\_to\_lead\_flag** `integer ("0" | "1")`
>
> If set to 1, the note will be pinned to the lead. 0 or omit to not pin.
>
> **pinned\_to\_person\_flag** `integer ("0" | "1")`
>
> If set to 1, the note will be pinned to the person. 0 or omit to not pin.
>
> **pinned\_to\_project\_flag** `integer ("0" | "1")`
>
> If set to 1, the note will be pinned to the project. 0 or omit to not pin.
>
> **pinned\_to\_organization\_flag** `integer ("0" | "1")`
>
> If set to 1, the note will be pinned to the organization. 0 or omit to not pin.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add comment to note
>
> **Slug:** `PIPEDRIVE_ADD_NOTE_COMMENT`
>
> Tool to add a comment to an existing note in Pipedrive. Use when you need to add commentary or updates to notes linked to deals, persons, or organizations.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note to add a comment to.
>
> **content** `string` *required*
>
> The content of the comment in HTML format. Subject to sanitization on the back-end.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new organization field
>
> **Slug:** `PIPEDRIVE_ADD_ORGANIZATION_FIELD`
>
> Adds a custom field to Pipedrive organizations. Specify its name and type, options for set or enum fields, and optionally whether it appears in the add-new form. Requires admin scope.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the field
>
> **options** `array`
>
> When `field_type` is either `set` or `enum`, possible options must be supplied as a JSON-encoded sequential array, for example:\</br>`[{"label":"red"}, {"label":"blue"}, {"label":"lilac"}]`
>
> **field\_type** `string ("varchar" | "varchar_auto" | "text" | "double" | "monetary" | "date" | "set" | "enum" | "user" | "org" | "people" | "phone" | "time" | "timerange" | "daterange" | "address")` *required*
>
> The type of the field\<table>\<tr>\<th>Value\</th>\<th>Description\</th>\</tr>\<tr>\<td>`varchar`\</td>\<td>Text (up to 255 characters)\</td>\<tr>\<td>`varchar_auto`\</td>\<td>Autocomplete text (up to 255 characters)\</td>\<tr>\<td>`text`\</td>\<td>Long text (up to 65k characters)\</td>\<tr>\<td>`double`\</td>\<td>Numeric value\</td>\<tr>\<td>`monetary`\</td>\<td>Monetary field (has a numeric value and a currency value)\</td>\<tr>\<td>`date`\</td>\<td>Date (format YYYY-MM-DD)\</td>\<tr>\<td>`set`\</td>\<td>Options field with a possibility of having multiple chosen options\</td>\<tr>\<td>`enum`\</td>\<td>Options field with a single possible chosen option\</td>\<tr>\<td>`user`\</td>\<td>User field (contains a user ID of another Pipedrive user)\</td>\<tr>\<td>`org`\</td>\<td>Organization field (contains an organization ID which is stored on the same account)\</td>\<tr>\<td>`people`\</td>\<td>Person field (contains a product ID which is stored on the same account)\</td>\<tr>\<td>`phone`\</td>\<td>Phone field (up to 255 numbers and/or characters)\</td>\<tr>\<td>`time`\</td>\<td>Time field (format HH:MM:SS)\</td>\<tr>\<td>`timerange`\</td>\<td>Time-range field (has a start time and end time value, both HH:MM:SS)\</td>\<tr>\<td>`daterange`\</td>\<td>Date-range field (has a start date and end date value, both YYYY-MM-DD)\</td>\<tr>\<td>`address`\</td>\<td>Address field (autocompleted by Google Maps)\</dd>\</table>
>
> **add\_visible\_flag** `boolean`
>
> Whether the field is available in "add new" modal or not (both in web and mobile app)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Organization Field Options
>
> **Slug:** `PIPEDRIVE_ADD_ORGANIZATION_FIELD_OPTIONS`
>
> Tool to add new options to an organization field in Pipedrive. Use when you need to add new choices to enum or set type organization fields. This is an atomic operation where all options are added or none.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to add to the field. At least one option must be provided. This is an atomic operation - all options are added or none.
>
> **field\_code** `string` *required*
>
> The unique code identifying the organization field (enum or set type) to add options to
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add organization follower
>
> **Slug:** `PIPEDRIVE_ADD_ORGANIZATION_FOLLOWER`
>
> Tool to add a follower to an organization in Pipedrive. Use when you need to create a follower relationship between a user and an organization entity.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **user\_id** `integer` *required*
>
> The ID of the user to add as a follower to the organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add or update role setting
>
> **Slug:** `PIPEDRIVE_ADD_OR_UPDATE_ROLE_SETTING`
>
> Adds or updates the visibility setting for a role. Notes: - Roles endpoints require the `admin` OAuth scope. - OAuth calls must target the company domain with `/api/v1` path, e.g., https\://\{COMPANY}.pipedrive.com/api/v1/roles/\{id}/settings - This action normalizes the base URL accordingly.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **value** `integer` *required*
>
> Possible values for the `default_visibility` setting depending on the subscription plan:\
> &#x20;\<table class="role-setting"> \<caption>\<b>Essential / Advanced plan\</b>\</caption> \<tr>\<th>\<b>Value\</b>\</th>\<th>\<b>Description\</b>\</th>\</tr> \<tr>\<td>`1`\</td>\<td>Owner & Followers\</td>\</tr> \<tr>\<td>`3`\</td>\<td>Entire company\</td>\</tr> \</table> \
> &#x20;\<table class="role-setting"> \<caption>\<b>Professional / Enterprise plan\</b>\</caption> \<tr>\<th>\<b>Value\</b>\</th>\<th>\<b>Description\</b>\</th>\</tr> \<tr>\<td>`1`\</td>\<td>Owner only\</td>\</tr> \<tr>\<td>`3`\</td>\<td>Owner's visibility group\</td>\</tr> \<tr>\<td>`5`\</td>\<td>Owner's visibility group and sub-groups\</td>\</tr> \<tr>\<td>`7`\</td>\<td>Entire company\</td>\</tr> \</table> \
> &#x20;Read more about visibility groups \<a href="[https://support.pipedrive.com/en/article/visibility-groups"\&gt;here\&lt;/a](https://support.pipedrive.com/en/article/visibility-groups"\&gt;here\&lt;/a)>.
>
> **setting\_key** `string ("deal_default_visibility" | "lead_default_visibility" | "org_default_visibility" | "person_default_visibility" | "product_default_visibility")` *required*
>
> Setting Key
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new person field
>
> **Slug:** `PIPEDRIVE_ADD_PERSON_FIELD`
>
> Adds a custom field to Pipedrive person records. Specify its name and type, options for set or enum fields, and optionally whether it appears in the add-new form. Requires contact-fields:full or admin scope.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the field
>
> **options** `array`
>
> When field\_type is either set or enum, possible options must be supplied as a JSON-encoded sequential array, for example: \[\{"label":"red"}, \{"label":"blue"}]
>
> **api\_token** `string`
>
> Optional API token to use as query parameter when OAuth scope does not permit POST; if provided, overrides Authorization header.
>
> **field\_type** `string ("address" | "date" | "daterange" | "double" | "enum" | "monetary" | "org" | "people" | "phone" | "set" | "text" | "time" | "timerange" | "user" | "varchar" | "varchar_auto" | "visible_to")` *required*
>
> The type of the field. Allowed: address, date, daterange, double, enum, monetary, org, people, phone, set, text, time, timerange, user, varchar, varchar\_auto, visible\_to.
>
> **add\_visible\_flag** `boolean`
>
> Whether the field is available in the add new modal (web and mobile). Default true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add person field options
>
> **Slug:** `PIPEDRIVE_ADD_PERSONFIELDS_OPTIONS`
>
> Tool to bulk add options to enum/set person fields atomically. Use when you need to add new options to a person field.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to create. Each object must contain a 'label' field. At least one option is required. The operation is atomic - all options are added or none are added.
>
> **field\_code** `string` *required*
>
> The unique code identifying the person field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a follower to a person
>
> **Slug:** `PIPEDRIVE_ADD_PERSON_FOLLOWER`
>
> Tool to add a follower to a person in Pipedrive. Use when you need to create a follower relationship between a user and a person entity.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person to add a follower to
>
> **user\_id** `integer` *required*
>
> The ID of the user to add as a follower to the person
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add person picture
>
> **Slug:** `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 128 and 512 pixels.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **file** `object`
>
> Image file to set as the person's picture (GIF/JPG/PNG)
>
> **crop\_x** `integer`
>
> Crop X (pixels)
>
> **crop\_y** `integer`
>
> Crop Y (pixels)
>
> **crop\_width** `integer`
>
> Crop width (pixels)
>
> **crop\_height** `integer`
>
> Crop height (pixels)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new pipeline
>
> **Slug:** `PIPEDRIVE_ADD_PIPELINE`
>
> Adds a new pipeline (v2).
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the pipeline
>
> **is\_deal\_probability\_enabled** `boolean`
>
> Whether deal probability is enabled for this pipeline
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a product
>
> **Slug:** `PIPEDRIVE_ADD_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](https://pipedrive.readme.io/docs/adding-a-product)" target="\_blank" rel="noopener noreferrer">adding a product\</a>.
>
> #### Input Parameters
>
> **tax** `number`
>
> Tax percentage
>
> **code** `string`
>
> Product code
>
> **name** `string` *required*
>
> Product name; cannot be empty
>
> **unit** `string`
>
> Sales unit of the product
>
> **prices** `array`
>
> Array of prices per currency
>
> **category** `integer`
>
> Product category
>
> **owner\_id** `integer`
>
> Owner user ID; if omitted, authorized user ID is used
>
> **visible\_to** `integer`
>
> Product visibility setting
>
> **description** `string`
>
> Product description
>
> **is\_linkable** `boolean`
>
> Whether the product can be added to a deal
>
> **billing\_frequency** `string`
>
> Billing frequency (one-time, annually, semi-annually, quarterly, monthly, weekly)
>
> **billing\_frequency\_cycles** `integer`
>
> Number of billing repeats (rules depend on billing\_frequency)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new product field
>
> **Slug:** `PIPEDRIVE_ADD_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](https://pipedrive.readme.io/docs/adding-a-new-custom-field)" target="\_blank" rel="noopener noreferrer">adding a new custom field\</a>.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the field
>
> **options** `array`
>
> When `field_type` is either `set` or `enum`, possible options must be supplied as a JSON-encoded sequential array, for example:\</br>`[{"label":"red"}, {"label":"blue"}, {"label":"lilac"}]`
>
> **field\_type** `string ("varchar" | "varchar_auto" | "text" | "double" | "monetary" | "date" | "set" | "enum" | "user" | "org" | "people" | "phone" | "time" | "timerange" | "daterange" | "address")` *required*
>
> The type of the field\<table>\<tr>\<th>Value\</th>\<th>Description\</th>\</tr>\<tr>\<td>`varchar`\</td>\<td>Text (up to 255 characters)\</td>\<tr>\<td>`varchar_auto`\</td>\<td>Autocomplete text (up to 255 characters)\</td>\<tr>\<td>`text`\</td>\<td>Long text (up to 65k characters)\</td>\<tr>\<td>`double`\</td>\<td>Numeric value\</td>\<tr>\<td>`monetary`\</td>\<td>Monetary field (has a numeric value and a currency value)\</td>\<tr>\<td>`date`\</td>\<td>Date (format YYYY-MM-DD)\</td>\<tr>\<td>`set`\</td>\<td>Options field with a possibility of having multiple chosen options\</td>\<tr>\<td>`enum`\</td>\<td>Options field with a single possible chosen option\</td>\<tr>\<td>`user`\</td>\<td>User field (contains a user ID of another Pipedrive user)\</td>\<tr>\<td>`org`\</td>\<td>Organization field (contains an organization ID which is stored on the same account)\</td>\<tr>\<td>`people`\</td>\<td>Person field (contains a product ID which is stored on the same account)\</td>\<tr>\<td>`phone`\</td>\<td>Phone field (up to 255 numbers and/or characters)\</td>\<tr>\<td>`time`\</td>\<td>Time field (format HH:MM:SS)\</td>\<tr>\<td>`timerange`\</td>\<td>Time-range field (has a start time and end time value, both HH:MM:SS)\</td>\<tr>\<td>`daterange`\</td>\<td>Date-range field (has a start date and end date value, both YYYY-MM-DD)\</td>\<tr>\<td>`address`\</td>\<td>Address field (autocompleted by Google Maps)\</dd>\</table>
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add product field options
>
> **Slug:** `PIPEDRIVE_ADD_PRODUCTFIELDS_OPTIONS`
>
> Tool to add new options to a product custom field that supports options (enum or set field types). Use when you need to expand the available choices for a product field. This operation is atomic - all options are added or none are added.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to add. At least one option is required. Each option must have a label field.
>
> **field\_code** `string` *required*
>
> The unique code identifying the field to add options to. This field must be of type enum or set.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add follower to product
>
> **Slug:** `PIPEDRIVE_ADD_PRODUCT_FOLLOWER`
>
> Tool to add a follower to a product in Pipedrive. Use when you need to have a user follow a specific product for updates and notifications.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product to which the follower will be added
>
> **user\_id** `integer` *required*
>
> The ID of the user to add as a follower to the product
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Product Image
>
> **Slug:** `PIPEDRIVE_ADD_PRODUCT_IMAGE`
>
> Tool to upload an image for a product in Pipedrive. Use when you need to add a visual representation to a product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product to add the image to
>
> **data** `object` *required*
>
> The image file to upload (PNG, JPG, GIF). Provide the file content as base64-encoded string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create product variation
>
> **Slug:** `PIPEDRIVE_ADD_PRODUCT_VARIATION`
>
> Tool to create a new product variation for an existing product. Use when you need to add a variation with customizable name and prices in multiple currencies.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product to add the variation to
>
> **name** `string` *required*
>
> The name of the product variation (maximum 255 characters)
>
> **prices** `array`
>
> Array of price objects for different currencies. If omitted, system assigns default values: price of 0, cost of 0, direct\_cost of 0, and the user's default currency. Only one price per variation per currency is supported.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a project
>
> **Slug:** `PIPEDRIVE_ADD_PROJECT`
>
> Adds a new project to Pipedrive. The response contains the API response body, including any reported error.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> The title of the project
>
> **labels** `array`
>
> IDs of labels for this project
>
> **org\_id** `integer`
>
> ID of associated organization
>
> **status** `string`
>
> Project status
>
> **board\_id** `integer` *required*
>
> The ID of a project board
>
> **deal\_ids** `array`
>
> IDs of deals associated with this project
>
> **end\_date** `string`
>
> Project end date (YYYY-MM-DD)
>
> **owner\_id** `integer`
>
> Project owner's ID
>
> **phase\_id** `integer` *required*
>
> The ID of a phase on the project board
>
> **person\_id** `integer`
>
> ID of associated person
>
> **start\_date** `string`
>
> Project start date (YYYY-MM-DD)
>
> **description** `string`
>
> Project description
>
> **template\_id** `integer`
>
> ID of the template the project will be based on
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a recurring subscription
>
> **Slug:** `PIPEDRIVE_ADD_RECURRING_SUBSCRIPTION`
>
> Adds a recurring subscription to a deal. The operation may instead create and attach a product representing recurring billing; a product attachment is not a recurring subscription.
>
> #### Input Parameters
>
> **deal\_id** `integer` *required*
>
> The ID of the deal this recurring subscription is associated with
>
> **currency** `string` *required*
>
> The currency of the recurring subscription. Accepts a 3-character currency code.
>
> **infinite** `boolean`
>
> This indicates that the recurring subscription will last until it"s manually canceled or deleted. Note that only one field must be set: `cycles_count` or `infinite`.
>
> **payments** `array`
>
> Array of additional payments. It requires a minimum structure as follows: \[\{ amount:SUM, description:DESCRIPTION, due\_at:PAYMENT\_DATE }]. Replace SUM with a payment amount, DESCRIPTION with an explanation string, PAYMENT\_DATE with a date (format YYYY-MM-DD).
>
> **start\_date** `string` *required*
>
> The start date of the recurring subscription. Format: YYYY-MM-DD
>
> **description** `string`
>
> The description of the recurring subscription
>
> **cadence\_type** `string ("weekly" | "monthly" | "quarterly" | "semi-annually" | "annually" | "yearly" | "custom")` *required*
>
> The interval between payments
>
> **cycle\_amount** `integer` *required*
>
> The amount of each payment
>
> **cycles\_count** `integer`
>
> Shows how many payments the subscription has. Note that one field must be set: `cycles_count` or `infinite`. If `cycles_count` is set, then `cycle_amount` and `start_date` are also required.
>
> **update\_deal\_value** `boolean`
>
> Indicates that the deal value must be set to recurring subscription"s MRR value
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a role
>
> **Slug:** `PIPEDRIVE_ADD_ROLE`
>
> Adds a new role. Roles endpoints require the admin scope.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the role
>
> **parent\_role\_id** `integer`
>
> The ID of the parent role
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add role assignment
>
> **Slug:** `PIPEDRIVE_ADD_ROLE_ASSIGNMENT`
>
> Assigns a user to a role. Notes: - Roles endpoints require the `admin` OAuth scope. - OAuth calls must target the company domain with `/api/v1` path, e.g., https\://\{COMPANY}.pipedrive.com/api/v1/roles/\{id}/assignments - This action normalizes the base URL accordingly and ensures JSON body is sent.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **user\_id** `integer` *required*
>
> The ID of the user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new stage
>
> **Slug:** `PIPEDRIVE_ADD_STAGE`
>
> Adds a new stage, returns the ID upon success.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the stage
>
> **pipeline\_id** `integer` *required*
>
> The ID of the pipeline to add stage to
>
> **rotten\_days** `integer`
>
> The number of days the deals not updated in this stage would become rotten. Applies only if the `rotten_flag` is set. (v2: days\_to\_rotten)
>
> **rotten\_flag** `boolean`
>
> Whether deals in this stage can become rotten (v1: rotten\_flag; v2: is\_deal\_rot\_enabled)
>
> **deal\_probability** `integer`
>
> The success probability percentage of the deal. Used/shown when deal weighted values are used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a task
>
> **Slug:** `PIPEDRIVE_ADD_TASK`
>
> Adds a new task.
>
> #### Input Parameters
>
> **done** `integer`
>
> 0 = Not done, 1 = Done
>
> **title** `string` *required*
>
> The title of the task
>
> **due\_date** `string`
>
> The task’s due date (YYYY-MM-DD)
>
> **project\_id** `integer` *required*
>
> The ID of a project
>
> **assignee\_id** `integer`
>
> The assignee user ID
>
> **description** `string`
>
> The description of the task
>
> **parent\_task\_id** `integer`
>
> The ID of a parent task; cannot be a subtask’s ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new team
>
> **Slug:** `PIPEDRIVE_ADD_TEAM`
>
> Adds a new team to the company and returns the created object.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The team name
>
> **users** `array`
>
> The list of user IDs
>
> **manager\_id** `integer` *required*
>
> The team manager ID
>
> **description** `string`
>
> The team description
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add users to a team
>
> **Slug:** `PIPEDRIVE_ADD_TEAM_USERS`
>
> Adds users to an existing team.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the team
>
> **users** `array` *required*
>
> The list of user IDs
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a new user
>
> **Slug:** `PIPEDRIVE_ADD_USER`
>
> Adds a new user to the company, returns the ID upon success.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email of the user
>
> **access** `array`
>
> The access given to the user. Each item in the array represents access to a specific app. Optionally may include either admin flag or permission set ID to specify which access to give within the app. If both are omitted, the default access for the corresponding app will be used. It requires structure as follows: `[{ app: "sales", permission_set_id: "62cc4d7f-4038-4352-abf3-a8c1c822b631" }, { app: "global", admin: true }, { app: "account_settings" }]`
>
> **active\_flag** `boolean`
>
> Whether the user is active or not. `false` = Not activated, `true` = Activated
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Archive a project
>
> **Slug:** `PIPEDRIVE_ARCHIVE_PROJECT`
>
> Archives a project.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Cancel a recurring subscription
>
> **Slug:** `PIPEDRIVE_CANCEL_RECURRING_SUBSCRIPTION`
>
> Cancels a recurring subscription, optionally specifying a termination date. The operation may instead disable product attachments on the deal whose ID matches the supplied ID; disabling attachments does not cancel the subscription, and changes can be partial.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the subscription. Fallback: treated as the deal ID when Subscriptions API is unavailable.
>
> **end\_date** `string`
>
> The subscription termination date. All payments after the specified date will be deleted. The end\_date of the subscription will be set to the due date of the payment to follow the specified date. Default value is the current date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Convert deal to lead
>
> **Slug:** `PIPEDRIVE_CONVERT_DEAL_TO_LEAD`
>
> Tool to convert a Pipedrive deal to a lead asynchronously. Use when you need to move a deal back to the lead stage, transferring related entities like notes, files, emails, and activities. Requires global admin or 'Convert deals to leads' permission.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal to convert to a lead
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Convert Lead to Deal
>
> **Slug:** `PIPEDRIVE_CONVERT_LEAD_TO_DEAL`
>
> Tool to convert a Pipedrive lead to a deal asynchronously. Use when you need to convert an existing lead into a deal. The conversion transfers all related entities (notes, files, emails, activities) to the new deal. Upon successful conversion, the lead is marked as deleted. Use the returned conversion\_id to check the conversion status.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the lead to convert (UUID format)
>
> **stage\_id** `integer`
>
> The ID of a stage the created deal will be added to. The pipeline will be assigned automatically based on the stage\_id. Do not use both pipeline\_id and stage\_id together.
>
> **pipeline\_id** `integer`
>
> The ID of a pipeline the created deal will be added to. The deal will be added to the first stage of the specified pipeline. Note: pipeline\_id will be ignored if both pipeline\_id and stage\_id are provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create an organization relationship
>
> **Slug:** `PIPEDRIVE_CREATE_ORGANIZATION_RELATIONSHIP`
>
> Creates and returns an organization relationship.
>
> #### Input Parameters
>
> **type** `string ("parent" | "related")` *required*
>
> The type of organization relationship
>
> **org\_id** `integer`
>
> The ID of the base organization for the returned calculated values
>
> **rel\_owner\_org\_id** `integer` *required*
>
> The owner of the relationship. If type is `parent`, then the owner is the parent and the linked organization is the daughter.
>
> **rel\_linked\_org\_id** `integer` *required*
>
> The linked organization in the relationship. If type is `parent`, then the linked organization is the daughter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a remote file and link it to an item
>
> **Slug:** `PIPEDRIVE_CREATE_REMOTE_FILE_LINK`
>
> Creates an empty file on Google Drive linked to an item. For details, refer to the Pipedrive remote file adding tutorial.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> The title of the file
>
> **item\_id** `integer` *required*
>
> The ID of the item to associate the file with
>
> **file\_type** `string ("gdoc" | "gslides" | "gsheet" | "gform" | "gdraw")` *required*
>
> The file type
>
> **item\_type** `string ("deal" | "organization" | "person")` *required*
>
> The item type
>
> **remote\_location** `string ("googledrive")` *required*
>
> The location type to send the file to. Only `googledrive` is supported at the moment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a new webhook
>
> **Slug:** `PIPEDRIVE_CREATE_WEBHOOK`
>
> Creates a webhook and returns its details. Specify an event action and object, including wildcards for supported events; webhook version 2.0 is the default, with version 1.0 also selectable.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The webhook’s name
>
> **user\_id** `integer`
>
> The ID of the user that this webhook will be authorized with. You have the option to use a different user"s `user_id`. If it is not set, the current user"s `user_id` will be used. As each webhook event is checked against a user"s permissions, the webhook will only be sent if the user has access to the specified object(s). If you want to receive notifications for all events, please use a top-level admin user’s `user_id`.
>
> **version** `string ("1.0" | "2.0")`
>
> The webhook"s version
>
> **event\_action** `string ("added" | "updated" | "merged" | "deleted" | "create" | "change" | "delete" | "*")` *required*
>
> The type of action to receive notifications about. Wildcard will match all supported actions.
>
> **event\_object** `string ("activity" | "activityType" | "deal" | "note" | "organization" | "person" | "pipeline" | "product" | "stage" | "user" | "lead" | "*")` *required*
>
> The type of object to receive notifications about. Wildcard will match all supported objects.
>
> **http\_auth\_user** `string`
>
> The HTTP basic auth username of the subscription URL endpoint (if required)
>
> **subscription\_url** `string` *required*
>
> A full, valid, publicly accessible URL which determines where to send the notifications. Please note that you cannot use Pipedrive API endpoints as the `subscription_url` and the chosen URL must not redirect to another link.
>
> **http\_auth\_password** `string`
>
> The HTTP basic auth password of the subscription URL endpoint (if required)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all ActivityFields
>
> **Slug:** `PIPEDRIVE_CTIVITYIELDS_GET_ALL_ACTIVITYFIELDS`
>
> Tool to retrieve metadata about all activity fields in the company. Use when you need to get information about field structure, types, options, and properties for activities.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Pagination limit for number of results to return. Default: 100, Maximum: 500
>
> **cursor** `string`
>
> Marker for pagination to fetch the next page of results
>
> **include\_fields** `string`
>
> Optional comma separated string array of additional data namespaces to include in response (e.g., 'ui\_visibility')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update deal product
>
> **Slug:** `PIPEDRIVE_DEALS_UPDATE_DEAL`
>
> Tool to update product details attached to a deal in Pipedrive using the v2 API. Use when you need to modify product attributes like price, quantity, discount, or tax for a deal-product attachment.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **tax** `number`
>
> Product tax amount (default: 0)
>
> **comments** `string`
>
> Product notes/comments
>
> **discount** `number`
>
> Discount value - amount or percentage based on discount\_type (default: 0)
>
> **quantity** `number`
>
> Quantity of the product
>
> **is\_enabled** `boolean`
>
> Whether product is active/enabled for the deal. Note: API v2 uses strict validation - only accepts true/false, not 1/0.
>
> **item\_price** `number`
>
> Price value for the product
>
> **product\_id** `integer`
>
> The product identifier
>
> **tax\_method** `string ("exclusive" | "inclusive" | "none")`
>
> Tax application method - 'exclusive' (tax not included in price), 'inclusive' (tax included in price), or 'none' (no tax)
>
> **discount\_type** `string ("percentage" | "amount")`
>
> Discount type - either 'percentage' or 'amount'
>
> **billing\_frequency** `string ("one-time" | "annually" | "semi-annually" | "quarterly" | "monthly" | "weekly")`
>
> Billing cycle option for Growth+ plans - 'one-time', 'annually', 'semi-annually', 'quarterly', 'monthly', or 'weekly'
>
> **billing\_start\_date** `string`
>
> When billing commences (Growth+ plans). Format: YYYY-MM-DD
>
> **product\_variation\_id** `integer`
>
> Specific product variation identifier
>
> **product\_attachment\_id** `integer` *required*
>
> The ID of the deal-product attachment (correlation ID between deal and product, obtained from GET /deals/\{id}/products). This is NOT the same as the product\_id.
>
> **billing\_frequency\_cycles** `integer`
>
> Number of billing frequency repetitions (Growth+ plans)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple activities in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_ACTIVITIES_BULK`
>
> Marks multiple Pipedrive activities as deleted by their comma-separated IDs. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use DELETE /api/v2/activities instead.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated IDs of activities that will be deleted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Activity
>
> **Slug:** `PIPEDRIVE_DELETE_ACTIVITY`
>
> Tool to delete an activity in Pipedrive. Use when you need to remove an activity. This is a soft delete operation - the activity will be permanently deleted after 30 days.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the activity to be deleted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Activity Type
>
> **Slug:** `PIPEDRIVE_DELETE_ACTIVITY_TYPE`
>
> Tool to delete an activity type in Pipedrive. Use when you need to remove an activity type from the system. The activity type will be marked as deleted (active\_flag set to false) rather than permanently removed.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the activity type to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple activity types in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_ACTIVITY_TYPES_BULK`
>
> Marks multiple activity types as deleted.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated activity type IDs
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an activity
>
> **Slug:** `PIPEDRIVE_DELETE_AN_ACTIVITY`
>
> Marks an activity as deleted. After 30 days, the activity will be permanently deleted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the activity
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a person
>
> **Slug:** `PIPEDRIVE_DELETE_A_PERSON`
>
> Marks a person as deleted. After 30 days, the person will be permanently deleted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a person field
>
> **Slug:** `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](https://pipedrive.readme.io/docs/deleting-a-custom-field)" target="\_blank" rel="noopener noreferrer">deleting a custom field\</a>.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a stage
>
> **Slug:** `PIPEDRIVE_DELETE_A_STAGE`
>
> Marks a stage as deleted. Uses the company-domain v2 endpoint.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the stage
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a call log
>
> **Slug:** `PIPEDRIVE_DELETE_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, please use the endpoint which is specific for activities.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID received when you create the call log
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a channel
>
> **Slug:** `PIPEDRIVE_DELETE_CHANNEL`
>
> Requests deletion of a messenger channel along with its conversations and messages, using Messengers integration OAuth and a Messaging app extension manifest. The Channels API is deprecated; reported success can also result from a 404 or other unsuccessful responses.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the channel provided by the integration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete comment from note
>
> **Slug:** `PIPEDRIVE_DELETE_COMMENT`
>
> Tool to delete a comment from a note in Pipedrive. Use when you need to remove a specific comment that was previously added to a note. Users can only delete comments they created or if they have admin privileges.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note
>
> **commentId** `string` *required*
>
> The ID of the comment in UUID format
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a conversation
>
> **Slug:** `PIPEDRIVE_DELETE_CONVERSATION`
>
> Deletes a conversation from a messaging channel, using the Messengers integration OAuth scope and a Messaging app extension manifest. A not-found response is reported as success and does not confirm deletion. DEPRECATED: Pipedrive guaranteed access to this Channels API endpoint only until February 1, 2026; use an alternative solution.
>
> #### Input Parameters
>
> **channel\_\_id** `string` *required*
>
> The ID of the channel provided by the integration
>
> **conversation\_\_id** `string` *required*
>
> The ID of the conversation provided by the integration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Deal
>
> **Slug:** `PIPEDRIVE_DELETE_DEAL`
>
> Tool to delete a deal in Pipedrive. Use when you need to remove a deal. This is a soft delete operation - the deal will be permanently deleted after 30 days.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal to be deleted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Deal Discount
>
> **Slug:** `PIPEDRIVE_DELETE_DEAL_DISCOUNT`
>
> Tool to delete a discount from a deal in Pipedrive. Use when you need to remove a discount that was previously applied to a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **discount\_id** `string` *required*
>
> The ID of the discount to be deleted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a deal field
>
> **Slug:** `PIPEDRIVE_DELETE_DEAL_FIELD`
>
> Tool to delete a deal field in Pipedrive by marking it as deleted. Use when you need to remove a custom deal field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal field to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete deal field options
>
> **Slug:** `PIPEDRIVE_DELETE_DEAL_FIELD_OPTIONS`
>
> Tool to remove existing options from a deal custom field atomically. Use when you need to delete options from a deal field.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to delete. At least one option ID is required. The entire request fails if any option does not exist (atomic operation).
>
> **field\_code** `string` *required*
>
> The unique code identifying the deal field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple deal fields in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_DEAL_FIELDS_BULK`
>
> Marks multiple deal fields as deleted. API error payloads may be returned as data, so a returned response does not itself confirm deletion.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated field IDs to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete deal follower
>
> **Slug:** `PIPEDRIVE_DELETE_DEAL_FOLLOWER`
>
> Tool to delete a follower from a deal in Pipedrive. Use when you need to remove a user from a deal's follower list.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **follower\_id** `integer` *required*
>
> The ID of the follower to be removed from the deal
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a participant from a deal
>
> **Slug:** `PIPEDRIVE_DELETE_DEAL_PARTICIPANT`
>
> Deletes a participant from a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **deal\_participant\_id** `integer` *required*
>
> The ID of the participant of the deal
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Deal Product
>
> **Slug:** `PIPEDRIVE_DELETE_DEAL_PRODUCT`
>
> Tool to delete an attached product from a deal in Pipedrive. Use when you need to remove a product that was previously attached to a deal. Note: It is not possible to delete the attached product if the deal has installments associated with it.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **product\_attachment\_id** `integer` *required*
>
> The product attachment ID. This is returned as product\_attachment\_id after attaching a product to a deal, or as id when listing the products attached to a deal.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Deals Products
>
> **Slug:** `PIPEDRIVE_DELETE_DEAL_PRODUCTS`
>
> Tool to delete multiple products from a deal in Pipedrive. Use when you need to remove specific products or all products from a deal. Maximum 100 products can be deleted per request.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **ids** `string`
>
> Comma-separated list of deal product IDs to delete. If not provided, all deal products will be deleted up to 100 items. Maximum 100 IDs allowed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple deals in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_DEALS_BULK`
>
> Marks multiple deals as deleted using a comma-separated list of deal IDs. DEPRECATED: This API v1 endpoint is out of support and its availability and behavior are not guaranteed. Use DELETE /api/v2/deals instead.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated IDs that will be deleted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a file
>
> **Slug:** `PIPEDRIVE_DELETE_FILE`
>
> Tool to delete a file in Pipedrive. Use when you need to remove a file from the system. The file is marked as deleted immediately but will be permanently deleted after 30 days.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the file to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Pipedrive Filter
>
> **Slug:** `PIPEDRIVE_DELETE_FILTER`
>
> Tool to delete a filter in Pipedrive. Use when you need to remove a specific filter by its ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the filter to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple filters in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_FILTERS_BULK`
>
> Marks multiple filters as deleted.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated filter IDs to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete existing goal
>
> **Slug:** `PIPEDRIVE_DELETE_GOAL`
>
> Marks a goal as deleted. Notes: - Pipedrive Goals endpoints for OAuth live under `{companydomain}/api/v1`. The default base\_url is usually `{companydomain}/v1`, which would yield 404. We therefore normalize the base URL to `/api/v1` before issuing the DELETE.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the goal
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a lead
>
> **Slug:** `PIPEDRIVE_DELETE_LEAD`
>
> Deletes a specific lead.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the lead
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete lead label
>
> **Slug:** `PIPEDRIVE_DELETE_LEAD_LABEL`
>
> Tool to delete a specific lead label from Pipedrive. Use when you need to remove a lead label using its UUID identifier.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The UUID identifier of the lead label to be deleted. Must be in UUID format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete mail thread
>
> **Slug:** `PIPEDRIVE_DELETE_MAIL_THREAD`
>
> Marks a mail thread as deleted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the mail thread
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple product fields in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_MULTIPLE_PRODUCT_FIELDS`
>
> Marks multiple product fields as deleted.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated field IDs to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple stages in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_MULTIPLE_STAGES`
>
> Marks multiple Pipedrive stages as deleted using a comma-separated list of stage IDs. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use DELETE /api/v2/stages instead.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated stage IDs to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a note
>
> **Slug:** `PIPEDRIVE_DELETE_NOTE`
>
> Deletes a specific note.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an organization
>
> **Slug:** `PIPEDRIVE_DELETE_ORGANIZATION`
>
> Tool to delete an organization in Pipedrive. Use when you need to mark an organization as deleted. The organization will be permanently deleted after 30 days.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an organization field
>
> **Slug:** `PIPEDRIVE_DELETE_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](https://pipedrive.readme.io/docs/deleting-a-custom-field)" target="\_blank" rel="noopener noreferrer">deleting a custom field\</a>.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete organization field options
>
> **Slug:** `PIPEDRIVE_DELETE_ORGANIZATION_FIELD_OPTIONS`
>
> Tool to delete specified options from an organization field in Pipedrive. Use when you need to remove one or more options from an organization field by field code. The operation is atomic: if any option ID does not exist, the entire request fails and no options are deleted.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to delete. At least one option ID must be provided. The operation is atomic: the entire request fails if any specified option ID does not exist.
>
> **field\_code** `string` *required*
>
> The unique code identifying the organization field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple organization fields in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_ORGANIZATION_FIELDS_BULK`
>
> Marks multiple organization fields as deleted.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated field IDs to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete organization follower
>
> **Slug:** `PIPEDRIVE_DELETE_ORGANIZATION_FOLLOWER`
>
> Tool to delete a follower from an organization in Pipedrive. Use when you need to remove a user from an organization's follower list.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **follower\_id** `integer` *required*
>
> The ID of the follower to be removed from the organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an organization relationship
>
> **Slug:** `PIPEDRIVE_DELETE_ORGANIZATION_RELATIONSHIP`
>
> Deletes an organization relationship and returns the deleted ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization relationship
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple organizations in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_ORGANIZATIONS_BULK`
>
> Marks multiple Pipedrive organizations as deleted using a comma-separated list of IDs; the organizations are permanently deleted after 30 days. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use DELETE /api/v2/organizations instead.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated IDs that will be deleted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a person
>
> **Slug:** `PIPEDRIVE_DELETE_PERSON`
>
> Tool to delete a person in Pipedrive. Use when you need to mark a person as deleted. The person will be permanently deleted after 30 days.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a person field
>
> **Slug:** `PIPEDRIVE_DELETE_PERSON_FIELD`
>
> Tool to delete a person field from Pipedrive. Use when you need to remove a custom person field by its unique identifier.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique identifier of the person field to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete person field options
>
> **Slug:** `PIPEDRIVE_DELETE_PERSON_FIELD_OPTIONS`
>
> Tool to remove existing options from a person custom field atomically. Use when you need to delete options from a person field.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to delete. At least one option ID is required. The entire request fails if any option does not exist (atomic operation).
>
> **field\_code** `string` *required*
>
> The unique code identifying the person field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple person fields in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_PERSON_FIELDS_BULK`
>
> Marks multiple person fields as deleted.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated field IDs to delete
>
> **api\_token** `string`
>
> Optional API token to use as query parameter when OAuth scope does not permit DELETE; if provided, overrides Authorization header.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a follower from a person
>
> **Slug:** `PIPEDRIVE_DELETE_PERSON_FOLLOWER`
>
> Deletes a follower from a person.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **follower\_id** `integer` *required*
>
> The ID of the follower
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete person picture
>
> **Slug:** `PIPEDRIVE_DELETE_PERSON_PICTURE`
>
> Deletes a person’s picture. Note: Pipedrive may return a 400 with error "Item not found" when the person has no picture set. Since delete is idempotent, we treat this specific case as a successful no-op and return a normalized response rather than raising.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete multiple persons in bulk
>
> **Slug:** `PIPEDRIVE_DELETE_PERSONS_BULK`
>
> Marks multiple Pipedrive persons as deleted using a comma-separated list of IDs. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use DELETE /api/v2/persons instead.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The comma-separated IDs that will be deleted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a pipeline
>
> **Slug:** `PIPEDRIVE_DELETE_PIPELINE`
>
> Marks a pipeline as deleted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the pipeline
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a product
>
> **Slug:** `PIPEDRIVE_DELETE_PRODUCT`
>
> Marks a product as deleted. After 30 days, the product will be permanently deleted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a product field
>
> **Slug:** `PIPEDRIVE_DELETE_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](https://pipedrive.readme.io/docs/deleting-a-custom-field)" target="\_blank" rel="noopener noreferrer">deleting a custom field\</a>.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete product field options
>
> **Slug:** `PIPEDRIVE_DELETE_PRODUCT_FIELD_OPTIONS`
>
> Tool to remove existing options from a product custom field atomically. Use when you need to delete options from a product field.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to delete. At least one option ID is required. The entire request fails if any option does not exist (atomic operation).
>
> **field\_code** `string` *required*
>
> The unique code identifying the product field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a follower from a product
>
> **Slug:** `PIPEDRIVE_DELETE_PRODUCT_FOLLOWER`
>
> Deletes a follower from a product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **follower\_id** `integer` *required*
>
> The ID of the relationship between the follower and the product
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Product Image
>
> **Slug:** `PIPEDRIVE_DELETE_PRODUCT_IMAGE`
>
> Tool to delete an image from a product in Pipedrive. Use when you need to remove a product image.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product from which to delete the image
>
> **image\_id** `integer` *required*
>
> The ID of the image to delete from the product
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Product Variation
>
> **Slug:** `PIPEDRIVE_DELETE_PRODUCT_VARIATION`
>
> Tool to delete a product variation from a product in Pipedrive. Use when you need to remove a specific variation from a product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **product\_variation\_id** `integer` *required*
>
> The ID of the product variation to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a project
>
> **Slug:** `PIPEDRIVE_DELETE_PROJECT`
>
> Marks a project as deleted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a role
>
> **Slug:** `PIPEDRIVE_DELETE_ROLE`
>
> Marks a role as deleted. Note: This endpoint requires admin permissions. The API token must have the 'admin' scope to delete roles. The default role (ID=1) cannot be deleted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a role assignment
>
> **Slug:** `PIPEDRIVE_DELETE_ROLE_ASSIGNMENT`
>
> Removes the assigned user from a role and adds to the default role.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **user\_id** `integer` *required*
>
> The ID of the user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a stage
>
> **Slug:** `PIPEDRIVE_DELETE_STAGE`
>
> Deletes a Pipedrive pipeline stage by ID. DEPRECATED: The API v1 endpoint is out of support and its availability and behavior are not guaranteed. Use DELETE /api/v2/stages/\{id} instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the stage to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a subscription
>
> **Slug:** `PIPEDRIVE_DELETE_SUBSCRIPTION`
>
> Marks an installment or recurring subscription as deleted by ID. The operation may instead delete a deal product attachment with the same ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the subscription
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a task
>
> **Slug:** `PIPEDRIVE_DELETE_TASK`
>
> Marks a task as deleted. If the task has subtasks then those will also be deleted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the task
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete users from a team
>
> **Slug:** `PIPEDRIVE_DELETE_TEAM_USERS`
>
> Deletes users from an existing team.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the team
>
> **users** `array` *required*
>
> The list of user IDs
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete existing webhook
>
> **Slug:** `PIPEDRIVE_DELETE_WEBHOOK`
>
> Deletes the specified Webhook.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the Webhook to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download one file
>
> **Slug:** `PIPEDRIVE_DOWNLOAD_FILE`
>
> Initializes a file download.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the file
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Duplicate deal
>
> **Slug:** `PIPEDRIVE_DUPLICATE_DEAL`
>
> Duplicates a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Duplicate Product
>
> **Slug:** `PIPEDRIVE_DUPLICATE_PRODUCT`
>
> Tool to duplicate a specific product in Pipedrive. Use when you need to create a copy of an existing product with all its properties and pricing information.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product to duplicate
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enumerate accessible users for lead
>
> **Slug:** `PIPEDRIVE_ENUMERATE_ACCESSIBLE_USERS_FOR_LEAD`
>
> Lists the users permitted to access a lead.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the lead
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find goals
>
> **Slug:** `PIPEDRIVE_FIND_GOALS`
>
> Find goals using supported criteria, including goal status and period. The status filter defaults to active goals; specify both period start and end for time-based searches.
>
> #### Input Parameters
>
> **title** `string`
>
> The title of the goal
>
> **is\_active** `boolean`
>
> Whether the goal is active or not
>
> **type\_\_name** `string ("deals_won" | "deals_progressed" | "activities_completed" | "activities_added" | "deals_started" | "revenue_forecast")`
>
> The type of the goal. If provided, everyone"s goals will be returned.
>
> **period\_\_end** `string`
>
> The end date of the period for which to find goals. Date in format of YYYY-MM-DD.
>
> **assignee\_\_id** `integer`
>
> The ID of the user who"s goal to fetch. When omitted, only your goals will be returned.
>
> **period\_\_start** `string`
>
> The start date of the period for which to find goals. Date in format of YYYY-MM-DD. When `period.start` is provided, `period.end` must be provided too.
>
> **assignee\_\_type** `string ("person" | "company" | "team")`
>
> The type of the goal"s assignee. If provided, everyone"s goals will be returned.
>
> **type\_\_params\_\_stage\_\_id** `integer`
>
> The ID of the stage. Applicable to only `deals_progressed` type of goals. If provided, everyone"s goals will be returned.
>
> **expected\_\_outcome\_\_target** `integer`
>
> The numeric value of the outcome. If provided, everyone"s goals will be returned.
>
> **type\_\_params\_\_pipeline\_\_id** `array`
>
> An array of pipeline IDs or `null` for all pipelines. If provided, everyone"s goals will be returned.
>
> **expected\_\_outcome\_\_currency\_\_id** `integer`
>
> The numeric ID of the goal"s currency. Only applicable to goals with `expected_outcome.tracking_metric` with value `sum`. If provided, everyone"s goals will be returned.
>
> **type\_\_params\_\_activity\_\_type\_\_id** `array`
>
> An array of IDs or `null` for all activity types. Only applicable for `activities_completed` and/or `activities_added` types of goals. If provided, everyone"s goals will be returned.
>
> **expected\_\_outcome\_\_tracking\_\_metric** `string ("quantity" | "sum")`
>
> The tracking metric of the expected outcome of the goal. If provided, everyone"s goals will be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find users by name
>
> **Slug:** `PIPEDRIVE_FIND_USERS_BY_NAME`
>
> Finds users by name or, when email search is enabled, by email address.
>
> #### Input Parameters
>
> **term** `string` *required*
>
> The search term to look for
>
> **search\_by\_email** `integer`
>
> When enabled, the term will only be matched against email addresses of users. Default: `false`.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of an activity
>
> **Slug:** `PIPEDRIVE_GET_ACTIVITY`
>
> Returns the details of a specific activity.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the activity
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one activity field
>
> **Slug:** `PIPEDRIVE_GET_ACTIVITY_FIELD`
>
> Tool to retrieve detailed metadata for a specific activity field by its field code. Use when you need information about field structure, type, options, or properties.
>
> #### Input Parameters
>
> **field\_code** `string` *required*
>
> The unique code identifying the field (e.g., 'subject', 'due\_date', or a 40-character hash for custom fields)
>
> **include\_fields** `string ("ui_visibility")`
>
> Enum for additional data namespaces to include in response
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all activities assigned to a particular user
>
> **Slug:** `PIPEDRIVE_GET_ALL_ACTIVITIES_ASSIGNED_TO_A_PARTICULAR_USER`
>
> Returns all activities assigned to a particular user.
>
> #### Input Parameters
>
> **done** `integer`
>
> Whether the activity is done or not. 0 = Not done, 1 = Done. If omitted returns both done and not done activities.
>
> **type** `string`
>
> The type of the activity, can be one type or multiple types separated by a comma. This is in correlation with the `key_string` parameter of ActivityTypes.
>
> **limit** `integer`
>
> Number of activities to return per page (defaults to 100 if not specified)
>
> **start** `integer`
>
> For pagination, the position that represents the first result for the page
>
> **fields** `string`
>
> CLIENT-SIDE FILTERING: Comma-separated list of activity fields to include in the final response. Note: The Pipedrive API does not support native field selection - all fields are still fetched from the API, but the response is filtered before returning to reduce token usage in your application. This does not reduce API bandwidth or Pipedrive API costs. Common fields: id, subject, due\_date, due\_time, done, type, user\_id, person\_id, deal\_id, org\_id, note, add\_time, update\_time.
>
> **user\_id** `integer`
>
> The ID of the user whose activities will be fetched. If omitted, the user associated with the API token will be used. If 0, activities for all company users will be fetched based on the permission sets.
>
> **end\_date** `string`
>
> Use the activity due date where you wish to stop fetching activities from. Insert due date in YYYY-MM-DD format.
>
> **filter\_id** `integer`
>
> The ID of the filter to use (will narrow down results if used together with `user_id` parameter)
>
> **start\_date** `string`
>
> Use the activity due date where you wish to begin fetching activities from. Insert due date in YYYY-MM-DD format.
>
> **response\_detail** `string ("minimal" | "full")`
>
> Level of detail in the response. 'minimal' (default) excludes related\_objects (deals, persons, organizations, users) to reduce token usage. 'full' includes the complete API response with all related\_objects. Note: The API always returns related\_objects — 'minimal' filters them out client-side.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all activities beta
>
> **Slug:** `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 permissions.
>
> #### Input Parameters
>
> **done** `boolean`
>
> Whether the activity is done or not. `false` = Not done, `true` = Done. If omitted, returns both done and not done activities.
>
> **type** `string`
>
> The type of the activity, can be one type or multiple types separated by a comma. This is in correlation with the `key_string` parameter of ActivityTypes.
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed.
>
> **since** `string`
>
> The time boundary that points to the start of the range of data. Datetime in ISO 8601 format. E.g. 2022-11-01 08:55:59. Operates on the `update_time` field.
>
> **until** `string`
>
> The time boundary that points to the end of the range of data. Datetime in ISO 8601 format. E.g. 2022-11-01 08:55:59. Operates on the `update_time` field.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> **user\_id** `integer`
>
> The ID of the user whose activities will be fetched. If omitted, all activities are returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all activity fields
>
> **Slug:** `PIPEDRIVE_GET_ALL_ACTIVITY_FIELDS`
>
> Returns all activity fields.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all activity types
>
> **Slug:** `PIPEDRIVE_GET_ALL_ACTIVITY_TYPES`
>
> Returns all activity types.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all deal fields
>
> **Slug:** `PIPEDRIVE_GET_ALL_DEAL_FIELDS`
>
> Returns data about all deal fields.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Items shown per page. Must be > 0 if provided.
>
> **start** `integer`
>
> Pagination start. Must be >= 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all deals
>
> **Slug:** `PIPEDRIVE_GET_ALL_DEALS`
>
> Lists deals with filtering, sorting and pagination. Archived deals are not returned by default.
>
> #### Input Parameters
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys).
>
> **limit** `integer`
>
> Items shown per page (1-500). If not provided, 100 items will be returned.
>
> **start** `integer`
>
> Pagination start
>
> **status** `string ("open" | "won" | "lost" | "deleted" | "all_not_deleted")`
>
> Only fetch deals with a specific status. If omitted, all not deleted deals are returned. If set to deleted, deals that have been deleted up to 30 days ago will be included.
>
> **user\_id** `integer`
>
> If supplied, only deals matching the given user will be returned. However, `filter_id` and `owned_by_you` takes precedence over `user_id` when supplied.
>
> **stage\_id** `integer`
>
> If supplied, only deals within the given stage will be returned
>
> **filter\_id** `integer`
>
> The ID of the filter to use
>
> **owned\_by\_you** `integer`
>
> When supplied, only deals owned by you are returned. However, `filter_id` takes precedence over `owned_by_you` when both are supplied.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all deals beta
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed.
>
> **since** `string`
>
> The time boundary that points to the start of the range of data. Datetime in ISO 8601 format. E.g. 2022-11-01 08:55:59. Operates on the `update_time` field.
>
> **until** `string`
>
> The time boundary that points to the end of the range of data. Datetime in ISO 8601 format. E.g. 2022-11-01 08:55:59. Operates on the `update_time` field.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> **status** `string ("open" | "won" | "lost" | "deleted")`
>
> Only fetch deals with a specific status. If omitted, all not deleted deals are returned. If set to deleted, deals that have been deleted up to 30 days ago will be included.
>
> **user\_id** `integer`
>
> If supplied, only deals matching the given user will be returned
>
> **stage\_id** `integer`
>
> If supplied, only deals within the given stage will be returned
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all files
>
> **Slug:** `PIPEDRIVE_GET_ALL_FILES`
>
> Returns data about all files.
>
> #### Input Parameters
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys). Supported fields: `id`, `user_id`, `deal_id`, `person_id`, `org_id`, `product_id`, `add_time`, `update_time`, `file_name`, `file_type`, `file_size`, `comment`.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all filter helpers
>
> **Slug:** `PIPEDRIVE_GET_ALL_FILTER_HELPERS`
>
> Retrieves filter helper information, including operators, relative dates and address field components.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all filters
>
> **Slug:** `PIPEDRIVE_GET_ALL_FILTERS`
>
> Returns data about all filters.
>
> #### Input Parameters
>
> **type** `string ("deals" | "leads" | "org" | "people" | "products" | "activity" | "projects")`
>
> The types of filters to fetch
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all lead labels
>
> **Slug:** `PIPEDRIVE_GET_ALL_LEAD_LABELS`
>
> Returns details of all lead labels. This endpoint does not support pagination and all labels are always returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all leads
>
> **Slug:** `PIPEDRIVE_GET_ALL_LEADS`
>
> Lists non-archived leads with pagination, optional filters and sorting. The archived-status parameter is ignored by Pipedrive.
>
> #### Input Parameters
>
> **sort** `string`
>
> The field name and sorting mode. Format: 'field\_name ASC' or 'field\_name DESC'. Valid field names: id, title, owner\_id, creator\_id, was\_seen, expected\_close\_date, next\_activity\_id, add\_time (creation timestamp), update\_time. Note: Use 'add\_time' for creation time (NOT 'creation\_date'). Only first-level field keys are supported (no nested keys).
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned.
>
> **start** `integer`
>
> For pagination, the position that represents the first result for the page
>
> **owner\_id** `integer`
>
> If supplied, only leads matching the given user will be returned. However, `filter_id` takes precedence over `owner_id` when supplied.
>
> **filter\_id** `integer`
>
> Optional ID of a saved filter to apply. Filter IDs are account-specific and must be obtained from the user's Pipedrive account using the 'Get all filters' endpoint (GET /filters with type='leads'). Do not pass placeholder values like 1. When filter\_id is provided, it takes precedence over owner\_id, person\_id, and organization\_id parameters. If omitted, returns all leads without filtering.
>
> **person\_id** `integer`
>
> If supplied, only leads matching the given person will be returned. However, `filter_id` takes precedence over `person_id` when supplied.
>
> **archived\_status** `string ("archived" | "not_archived" | "all")`
>
> Filtering based on the archived status of a lead. If not provided, `All` is used.
>
> **organization\_id** `integer`
>
> If supplied, only leads matching the given organization will be returned. However, `filter_id` takes precedence over `organization_id` when supplied.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all lead sources
>
> **Slug:** `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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all note fields
>
> **Slug:** `PIPEDRIVE_GET_ALL_NOTE_FIELDS`
>
> Returns data about all note fields.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all notes
>
> **Slug:** `PIPEDRIVE_GET_ALL_NOTES`
>
> Returns all notes.
>
> #### Input Parameters
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys). Supported fields: `id`, `user_id`, `deal_id`, `person_id`, `org_id`, `content`, `add_time`, `update_time`.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **org\_id** `integer`
>
> The ID of the organization which notes to fetch. If omitted, notes about all organizations will be returned.
>
> **deal\_id** `integer`
>
> The ID of the deal which notes to fetch. If omitted, notes about all deals will be returned.
>
> **lead\_id** `string`
>
> The ID of the lead which notes to fetch. If omitted, notes about all leads will be returned.
>
> **user\_id** `integer`
>
> The ID of the user whose notes to fetch. If omitted, notes by all users will be returned.
>
> **end\_date** `string`
>
> The date in format of YYYY-MM-DD until which notes to fetch to
>
> **person\_id** `integer`
>
> The ID of the person whose notes to fetch. If omitted, notes about all persons will be returned.
>
> **start\_date** `string`
>
> The date in format of YYYY-MM-DD from which notes to fetch
>
> **pinned\_to\_deal\_flag** `integer`
>
> If set, the results are filtered by note to deal pinning state
>
> **pinned\_to\_lead\_flag** `integer`
>
> If set, the results are filtered by note to lead pinning state
>
> **pinned\_to\_person\_flag** `integer`
>
> If set, the results are filtered by note to person pinning state
>
> **pinned\_to\_organization\_flag** `integer`
>
> If set, the results are filtered by note to organization pinning state
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all organization fields
>
> **Slug:** `PIPEDRIVE_GET_ALL_ORGANIZATION_FIELDS`
>
> Returns data about all organization fields.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all organizations
>
> **Slug:** `PIPEDRIVE_GET_ALL_ORGANIZATIONS`
>
> Returns all organizations.
>
> #### Input Parameters
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys).
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **user\_id** `integer`
>
> If supplied, only organizations owned by the given user will be returned. However, `filter_id` takes precedence over `user_id` when both are supplied.
>
> **filter\_id** `integer`
>
> The ID of the filter to use
>
> **first\_char** `string`
>
> If supplied, only organizations whose name starts with the specified letter will be returned (case-insensitive)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all organizations beta
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed.
>
> **since** `string`
>
> The time boundary that points to the start of the range of data. Datetime in ISO 8601 format. E.g. 2022-11-01 08:55:59. Operates on the `update_time` field.
>
> **until** `string`
>
> The time boundary that points to the end of the range of data. Datetime in ISO 8601 format. E.g. 2022-11-01 08:55:59. Operates on the `update_time` field.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> **owner\_id** `integer`
>
> If supplied, only organizations owned by the given user will be returned
>
> **first\_char** `string`
>
> If supplied, only organizations whose name starts with the specified letter will be returned (case-insensitive)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all permission sets
>
> **Slug:** `PIPEDRIVE_GET_ALL_PERMISSION_SETS`
>
> Returns data about all permission sets.
>
> #### Input Parameters
>
> **app** `string ("sales" | "projects" | "campaigns" | "global" | "account_settings")`
>
> The app to filter the permission sets by
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all person fields
>
> **Slug:** `PIPEDRIVE_GET_ALL_PERSON_FIELDS`
>
> Returns data about all person fields.\
> 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_status` field.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all persons
>
> **Slug:** `PIPEDRIVE_GET_ALL_PERSONS`
>
> Returns all persons.
>
> #### Input Parameters
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys).
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **user\_id** `integer`
>
> If supplied, only persons owned by the given user will be returned. However, `filter_id` takes precedence over `user_id` when both are supplied.
>
> **filter\_id** `integer`
>
> The ID of the filter to use
>
> **first\_char** `string`
>
> If supplied, only persons whose name starts with the specified letter will be returned (case-insensitive)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all persons beta
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed.
>
> **since** `string`
>
> The time boundary that points to the start of the range of data. Datetime in ISO 8601 format. E.g. 2022-11-01 08:55:59. Operates on the `update_time` field.
>
> **until** `string`
>
> The time boundary that points to the end of the range of data. Datetime in ISO 8601 format. E.g. 2022-11-01 08:55:59. Operates on the `update_time` field.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> **owner\_id** `integer`
>
> If supplied, only persons owned by the given user will be returned
>
> **first\_char** `string`
>
> If supplied, only persons whose name starts with the specified letter will be returned (case-insensitive)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all pipelines
>
> **Slug:** `PIPEDRIVE_GET_ALL_PIPELINES`
>
> Returns data about all pipelines. This action retrieves all pipelines from the user's Pipedrive instance using their instance-specific URL (e.g., [https://company.pipedrive.com/api/v2/pipelines](https://company.pipedrive.com/api/v2/pipelines)).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all product fields
>
> **Slug:** `PIPEDRIVE_GET_ALL_PRODUCT_FIELDS`
>
> Returns data about all product fields.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all products
>
> **Slug:** `PIPEDRIVE_GET_ALL_PRODUCTS`
>
> Returns data about all products.
>
> #### Input Parameters
>
> **ids** `array`
>
> An array of integers with the IDs of the products that should be returned in the response
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **user\_id** `integer`
>
> If supplied, only products owned by the given user will be returned
>
> **filter\_id** `integer`
>
> The ID of the filter to use
>
> **first\_char** `string`
>
> If supplied, only products whose name starts with the specified letter will be returned (case-insensitive)
>
> **get\_summary** `boolean`
>
> If supplied, the response will return the total numbers of products in the `additional_data.summary.total_count` property
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all project boards
>
> **Slug:** `PIPEDRIVE_GET_ALL_PROJECT_BOARDS`
>
> Returns all projects boards that are not deleted. Note: The Projects feature requires the Projects add-on which is available on Power and Enterprise plans, or as a paid add-on for other plans. A 402 Payment Required error indicates the account does not have access to the Projects feature.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all projects
>
> **Slug:** `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](https://pipedrive.readme.io/docs/core-api-concepts-pagination)" target="\_blank" rel="noopener noreferrer">pagination\</a>.
>
> #### Input Parameters
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> **status** `string`
>
> If supplied, includes only projects with the specified statuses. Possible values are `open`, `completed`, `canceled` and `deleted`. By default `deleted` projects are not returned.
>
> **phase\_id** `integer`
>
> If supplied, only projects in specified phase are returned
>
> **filter\_id** `integer`
>
> The ID of the filter to use
>
> **include\_archived** `boolean`
>
> If supplied with `true` then archived projects are also included in the response. By default only not archived projects are returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all project templates
>
> **Slug:** `PIPEDRIVE_GET_ALL_PROJECT_TEMPLATES`
>
> Retrieves non-deleted project templates with cursor-based pagination; the Projects add-on must be enabled. HTTP errors produce an unsuccessful response with an empty template list.
>
> #### Input Parameters
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, up to 500 items will be returned.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all relationships for organization
>
> **Slug:** `PIPEDRIVE_GET_ALL_RELATIONSHIPS_FOR_ORGANIZATION`
>
> Gets all of the relationships for a supplied organization ID.
>
> #### Input Parameters
>
> **org\_id** `integer` *required*
>
> The ID of the organization to get relationships for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all roles
>
> **Slug:** `PIPEDRIVE_GET_ALL_ROLES`
>
> Returns roles within the company. The action requires the admin scope and supports pagination.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all stages
>
> **Slug:** `PIPEDRIVE_GET_ALL_STAGES`
>
> Returns data about all stages.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **pipeline\_id** `integer`
>
> The ID of the pipeline to fetch stages for. If omitted, stages for all pipelines will be fetched.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all supported currencies
>
> **Slug:** `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 ISO 4217 for all non-custom currencies.
>
> #### Input Parameters
>
> **term** `string`
>
> Optional search term that is searched for from currency"s name and/or code
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all tasks
>
> **Slug:** `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](https://pipedrive.readme.io/docs/core-api-concepts-pagination)" target="\_blank" rel="noopener noreferrer">pagination\</a>.
>
> #### Input Parameters
>
> **done** `integer`
>
> Whether the task is done or not. `0` = Not done, `1` = Done. If not omitted then returns both done and not done tasks.
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, up to 500 items will be returned.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> **project\_id** `integer`
>
> If supplied, only tasks that are assigned to this project are returned
>
> **assignee\_id** `integer`
>
> If supplied, only tasks that are assigned to this user are returned
>
> **parent\_task\_id** `integer`
>
> If `null` is supplied then only parent tasks are returned. If integer is supplied then only subtasks of a specific task are returned. By default all tasks are returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all teams
>
> **Slug:** `PIPEDRIVE_GET_ALL_TEAMS`
>
> Returns data about teams within the company.
>
> #### Input Parameters
>
> **order\_by** `string ("id" | "name" | "manager_id" | "active_flag")`
>
> The field name to sort returned teams by
>
> **skip\_users** `integer`
>
> When enabled, the teams will not include IDs of member users
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all teams of a user
>
> **Slug:** `PIPEDRIVE_GET_ALL_TEAMS_OF_A_USER`
>
> Returns data about all teams which have the specified user as a member.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> **order\_by** `string ("id" | "name" | "manager_id" | "active_flag")`
>
> The field name to sort returned teams by
>
> **skip\_users** `integer`
>
> When enabled, the teams will not include IDs of member users
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all user connections
>
> **Slug:** `PIPEDRIVE_GET_ALL_USER_CONNECTIONS`
>
> Returns data about all connections for the authorized user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all users
>
> **Slug:** `PIPEDRIVE_GET_ALL_USERS`
>
> Returns data about all users within the company.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all users in a team
>
> **Slug:** `PIPEDRIVE_GET_ALL_USERS_IN_A_TEAM`
>
> Returns a list of all user IDs within a team.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the team
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all webhooks
>
> **Slug:** `PIPEDRIVE_GET_ALL_WEBHOOKS`
>
> Returns data about all the Webhooks of a company.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get archived deals
>
> **Slug:** `PIPEDRIVE_GET_ARCHIVED_DEALS`
>
> Retrieves a page of archived deals with filtering and pagination using the API v1 archived-deals endpoint. Pipedrive described this v1 endpoint as temporary support through the end of 2025.
>
> #### Input Parameters
>
> **ids** `string`
>
> Optional comma separated string array of up to 100 entity ids to fetch
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. A maximum value of 500 is allowed (default: 100)
>
> **cursor** `string`
>
> Pagination marker for the next page of results
>
> **org\_id** `integer`
>
> Filters to deals linked to the specified organization
>
> **status** `string ("open" | "won" | "lost" | "deleted")`
>
> Deal status filter
>
> **sort\_by** `string ("id" | "update_time" | "add_time")`
>
> Supported sort fields for archived deals
>
> **owner\_id** `integer`
>
> Filters to deals owned by the specified user
>
> **stage\_id** `integer`
>
> Filters to deals in the specified stage
>
> **filter\_id** `integer`
>
> When supplied, returns only deals matching the specified filter
>
> **person\_id** `integer`
>
> Filters to deals linked to the specified person
>
> **pipeline\_id** `integer`
>
> Filters to deals in the specified pipeline
>
> **custom\_fields** `string`
>
> Optional comma separated string array of custom fields keys to include. A maximum of 15 keys is allowed
>
> **updated\_since** `string`
>
> RFC3339 format; returns deals with update\_time >= this value
>
> **updated\_until** `string`
>
> RFC3339 format; returns deals with update\_time \< this value
>
> **include\_fields** `string`
>
> Additional optional fields (next\_activity\_id, last\_activity\_id, first\_won\_time, products\_count, etc.)
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Sort direction for archived deals
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get archived leads
>
> **Slug:** `PIPEDRIVE_GET_ARCHIVED_LEADS`
>
> Tool to get all archived leads from Pipedrive. Use when you need to retrieve leads that have been archived, with support for filtering by owner, person, organization, or custom filter, and pagination.
>
> #### Input Parameters
>
> **sort** `string ("id" | "title" | "owner_id" | "creator_id" | "was_seen" | "expected_close_date" | "next_activity_id" | "add_time" | "update_time")`
>
> Supported sort fields for archived leads
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned.
>
> **start** `integer`
>
> For pagination, the position that represents the first result for the page
>
> **owner\_id** `integer`
>
> If supplied, only leads matching the given user will be returned. However, filter\_id takes precedence over owner\_id when supplied.
>
> **filter\_id** `integer`
>
> The ID of the filter to use
>
> **person\_id** `integer`
>
> If supplied, only leads matching the given person will be returned. However, filter\_id takes precedence over person\_id when supplied.
>
> **organization\_id** `integer`
>
> If supplied, only leads matching the given organization will be returned. However, filter\_id takes precedence over organization\_id when supplied.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get call log details
>
> **Slug:** `PIPEDRIVE_GET_CALL_LOG`
>
> Tool to retrieve details of a specific call log by ID. Use when you need to get complete information about a call log including duration, outcome, participants, and timestamps.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the call log to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one comment
>
> **Slug:** `PIPEDRIVE_GET_COMMENT`
>
> Returns the details of a comment on a note.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note
>
> **commentId** `string` *required*
>
> The ID of the comment
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all add ons for a single company
>
> **Slug:** `PIPEDRIVE_GET_COMPANY_ADD_ONS`
>
> Returns the add-ons for a single company.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get conversations for a channel
>
> **Slug:** `PIPEDRIVE_GET_CONVERSATIONS`
>
> Tool to retrieve messaging conversations. Use after channel registration to sync conversations.
>
> #### Input Parameters
>
> **after** `string`
>
> Cursor for fetching the next page of conversations
>
> **channel\_id** `string` *required*
>
> Unique ID of the messaging channel
>
> **messages\_limit** `integer`
>
> Maximum number of messages per conversation
>
> **conversations\_limit** `integer`
>
> Maximum number of conversations to return
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get current user data
>
> **Slug:** `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 account settings, not the chosen language.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Deal Details
>
> **Slug:** `PIPEDRIVE_GET_DEAL`
>
> Retrieves a Pipedrive deal by ID, with options to request additional fields and up to 15 custom field keys. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use GET /api/v2/deals/\{id} instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal to retrieve
>
> **custom\_fields** `string`
>
> Comma-separated list of custom field keys to include (maximum 15 keys). Use this parameter for faster results and smaller responses when only specific custom fields are needed.
>
> **include\_fields** `string`
>
> Comma-separated list of additional fields to include in the response. Acceptable values: next\_activity\_id, last\_activity\_id, first\_won\_time, products\_count, files\_count, notes\_count, followers\_count, email\_messages\_count, activities\_count, done\_activities\_count, undone\_activities\_count, participants\_count, last\_incoming\_mail\_time, last\_outgoing\_mail\_time, smart\_bcc\_email
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deal activities (Deprecated)
>
> **Slug:** `PIPEDRIVE_GET_DEAL_ACTIVITIES`
>
> DEPRECATED: Use PIPEDRIVE\_PIPEDRIVE\_ACTIVITIES\_UPDATE\_ACTIVITY or PIPEDRIVE\_LIST\_ACTIVITIES instead. Lists activities associated with a deal. Use when you need to retrieve all activities linked to a specific deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **done** `integer`
>
> Whether the activity is done or not. 0 = Not done, 1 = Done. If omitted returns both done and not done activities.
>
> **limit** `integer`
>
> Number of items displayed per page
>
> **start** `integer`
>
> Pagination starting point
>
> **exclude** `string`
>
> Comma-separated activity IDs to exclude from results
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Deal Changelog
>
> **Slug:** `PIPEDRIVE_GET_DEAL_CHANGELOG`
>
> Lists a page of field-value changes for a specific deal, with cursor pagination.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> Number of items to display per page. Controls the size of each paginated response.
>
> **cursor** `string`
>
> Pagination cursor for the first item on the next page. Use the cursor returned in the response to fetch the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one deal field
>
> **Slug:** `PIPEDRIVE_GET_DEAL_FIELD`
>
> Tool to retrieve a specific deal field by ID. Use when you need to get metadata and configuration for a deal field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal field to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Deal Files
>
> **Slug:** `PIPEDRIVE_GET_DEAL_FILES`
>
> Lists a page of files attached to a specific Pipedrive deal, with pagination and sorting.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **sort** `string`
>
> Supported fields for sorting: `id`, `update_time`. Example: 'id ASC' or 'update\_time DESC'.
>
> **limit** `integer`
>
> Items shown per page. Maximum value of 100 is allowed.
>
> **start** `integer`
>
> Pagination start. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deal followers
>
> **Slug:** `PIPEDRIVE_GET_DEAL_FOLLOWERS`
>
> Lists a page of users following a specific deal, with cursor pagination.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. Maximum value of 500 is allowed.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deal followers changelog
>
> **Slug:** `PIPEDRIVE_GET_DEAL_FOLLOWERS_CHANGELOG`
>
> Tool to retrieve changelogs about users who have followed a deal. Use when you need to track follower activity, showing when users were added or removed as followers.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> Number of items returned per page. Maximum value is 500.
>
> **cursor** `string`
>
> Pagination marker (opaque string) pointing to the first item on the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Deal Mail Messages
>
> **Slug:** `PIPEDRIVE_GET_DEAL_MAIL_MESSAGES`
>
> Tool to list mail messages associated with a deal in Pipedrive. Use when you need to retrieve email communications linked to a specific deal. Note: This returns mail message snippets only; for full email content, use the thread\_id and query mail threads separately.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal to retrieve mail messages for
>
> **limit** `integer`
>
> Number of items shown per page. If not provided, API default will be used.
>
> **start** `integer`
>
> Pagination start position. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Deal Participants
>
> **Slug:** `PIPEDRIVE_GET_DEAL_PARTICIPANTS`
>
> Lists a page of persons participating in a specific Pipedrive deal, with pagination.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> Items shown per page. Maximum value of 500 is allowed. Default is 100.
>
> **start** `integer`
>
> Pagination start. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Deal Participants Changelog
>
> **Slug:** `PIPEDRIVE_GET_DEAL_PARTICIPANTS_CHANGELOG`
>
> Lists a page of participant changes for a specific deal, with cursor pagination.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> Number of items to display per page. Maximum value is 500.
>
> **cursor** `string`
>
> Pagination cursor for the first item on the next page. Use the cursor returned in the response to fetch the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Deal Products
>
> **Slug:** `PIPEDRIVE_GET_DEAL_PRODUCTS`
>
> Lists a page of products attached to a specified Pipedrive deal, with pagination and sorting options. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use GET /api/v2/deals/\{id}/products instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. Maximum value of 500 is allowed. Default is 100.
>
> **cursor** `string`
>
> For pagination, the marker (opaque string value) representing the first item on the next page
>
> **sort\_by** `string`
>
> The field to sort by. Supported values: id, add\_time, update\_time, order\_nr. Default is 'id'.
>
> **sort\_direction** `string`
>
> The sorting direction. Supported values: asc, desc. Default is 'asc'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deals conversion rates in pipeline
>
> **Slug:** `PIPEDRIVE_GET_DEALS_CONVERSION_RATES_IN_PIPELINE`
>
> Returns all stage-to-stage conversion and pipeline-to-close rates for the given time period.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the pipeline
>
> **user\_id** `integer`
>
> The ID of the user who"s pipeline metrics statistics to fetch. If omitted, the authorized user will be used.
>
> **end\_date** `string` *required*
>
> The end of the period. Date in format of YYYY-MM-DD.
>
> **start\_date** `string` *required*
>
> The start of the period. Date in format of YYYY-MM-DD.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deal conversion status
>
> **Slug:** `PIPEDRIVE_GET_DEALS_CONVERT_STATUS`
>
> Tool to retrieve the conversion status for a deal-to-lead conversion operation. Use when you need to check the progress or result of a deal conversion job.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the deal
>
> **conversion\_id** `string` *required*
>
> The ID of the conversion job. The ID has UUID format
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deals discounts
>
> **Slug:** `PIPEDRIVE_GET_DEALS_DISCOUNTS`
>
> Tool to retrieve discounts for a specific deal. Use when you need to list all discounts added to a deal in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deals in a pipeline
>
> **Slug:** `PIPEDRIVE_GET_DEALS_IN_A_PIPELINE`
>
> Lists deals in a specific pipeline across its stages, with optional filters and pagination. Archived deals are excluded by default.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the pipeline
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **user\_id** `integer`
>
> If supplied, `filter_id` will not be considered and only deals owned by the given user will be returned. If omitted, deals owned by the authorized user will be returned.
>
> **everyone** `integer`
>
> If supplied, `filter_id` and `user_id` will not be considered – instead, deals owned by everyone will be returned
>
> **stage\_id** `integer`
>
> If supplied, only deals within the given stage will be returned
>
> **filter\_id** `integer`
>
> If supplied, only deals matching the given filter will be returned
>
> **get\_summary** `integer`
>
> Whether to include a summary of the pipeline in the `additional_data` or not
>
> **totals\_convert\_currency** `string`
>
> The 3-letter currency code of any of the supported currencies. When supplied, `per_stages_converted` is returned inside `deals_summary` inside `additional_data` which contains the currency-converted total amounts in the given currency per each stage. You may also set this parameter to `default_currency` in which case users default currency is used. Only works when `get_summary` parameter flag is enabled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deals in a stage
>
> **Slug:** `PIPEDRIVE_GET_DEALS_IN_A_STAGE`
>
> Lists deals in a specific stage, with optional filters and pagination. Archived deals are excluded by default.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the stage
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **user\_id** `integer`
>
> If supplied, `filter_id` will not be considered and only deals owned by the given user will be returned. If omitted, deals owned by the authorized user will be returned.
>
> **everyone** `integer`
>
> If supplied, `filter_id` and `user_id` will not be considered – instead, deals owned by everyone will be returned
>
> **filter\_id** `integer`
>
> If supplied, only deals matching the given filter will be returned
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Deals Products
>
> **Slug:** `PIPEDRIVE_GET_DEALS_PRODUCTS`
>
> Tool to retrieve products attached to specified deals (max 100 deals per request). Use when you need to get all products associated with multiple deals.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of entries per request (default: 100, max: 500)
>
> **cursor** `string`
>
> Pagination marker to retrieve the next page of results
>
> **sort\_by** `string`
>
> Field to sort by - supports 'id', 'deal\_id', 'add\_time', 'update\_time', or 'order\_nr' (default: 'id')
>
> **deal\_ids** `array` *required*
>
> IDs of the deals for which attached products will be returned. Maximum 100 deal IDs allowed.
>
> **sort\_direction** `string`
>
> Sort order - 'asc' or 'desc' (default: 'asc')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deals summary
>
> **Slug:** `PIPEDRIVE_GET_DEALS_SUMMARY`
>
> Requests a summary of deals, optionally filtered by status, user, filter or stage. Archived deals are excluded by default.
>
> #### Input Parameters
>
> **status** `string ("open" | "won" | "lost")`
>
> Only fetch deals with a specific status. open = Open, won = Won, lost = Lost.
>
> **user\_id** `integer`
>
> Only deals matching the given user will be returned. `user_id` will not be considered if you use `filter_id`.
>
> **stage\_id** `integer`
>
> Only deals within the given stage will be returned
>
> **filter\_id** `integer`
>
> \<code>user\_id\</code> will not be considered. Only deals matching the given filter will be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get archived deals summary
>
> **Slug:** `PIPEDRIVE_GET_DEALS_SUMMARY_ARCHIVED`
>
> Tool to retrieve summary statistics for archived deals. Use when you need aggregated data about archived deals including total count, values, and weighted values grouped by currency.
>
> #### Input Parameters
>
> **status** `string ("open" | "won" | "lost")`
>
> Deal status filter options
>
> **user\_id** `integer`
>
> Only deals matching the given user will be returned. user\_id will not be considered if you use filter\_id.
>
> **stage\_id** `integer`
>
> Only deals within the given stage will be returned
>
> **filter\_id** `integer`
>
> user\_id will not be considered. Only deals matching the given filter will be returned.
>
> **pipeline\_id** `integer`
>
> Only deals within the given pipeline will be returned
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deals timeline
>
> **Slug:** `PIPEDRIVE_GET_DEALS_TIMELINE`
>
> Returns opened and won deals in time-based groups according to a specified deal date field. Archived deals are excluded by default.
>
> #### Input Parameters
>
> **amount** `integer` *required*
>
> The number of given intervals, starting from `start_date`, to fetch. E.g. 3 (months).
>
> **user\_id** `integer`
>
> If supplied, only deals matching the given user will be returned
>
> **interval** `string ("day" | "week" | "month" | "quarter")` *required*
>
> The type of the interval\<table>\<tr>\<th>Value\</th>\<th>Description\</th>\</tr>\<tr>\<td>`day`\</td>\<td>Day\</td>\</tr>\<tr>\<td>`week`\</td>\<td>A full week (7 days) starting from `start_date`\</td>\</tr>\<tr>\<td>`month`\</td>\<td>A full month (depending on the number of days in given month) starting from `start_date`\</td>\</tr>\<tr>\<td>`quarter`\</td>\<td>A full quarter (3 months) starting from `start_date`\</td>\</tr>\</table>
>
> **field\_key** `string` *required*
>
> The date field key which deals will be retrieved from
>
> **filter\_id** `integer`
>
> If supplied, only deals matching the given filter will be returned
>
> **start\_date** `string` *required*
>
> The date when the first interval starts. Format: YYYY-MM-DD.
>
> **pipeline\_id** `integer`
>
> If supplied, only deals matching the given pipeline will be returned
>
> **exclude\_deals** `integer`
>
> Whether to exclude deals list (1) or not (0). Note that when deals are excluded, the timeline summary (counts and values) is still returned.
>
> **totals\_convert\_currency** `string`
>
> The 3-letter currency code of any of the supported currencies. When supplied, `totals_converted` is returned per each interval which contains the currency-converted total amounts in the given currency. You may also set this parameter to `default_currency` in which case the user"s default currency is used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find subscription by deal
>
> **Slug:** `PIPEDRIVE_GET_DEAL_SUBSCRIPTION`
>
> Finds an installment or recurring subscription by deal ID. The result may instead contain the deal's installments or attached products; products are not subscription details.
>
> #### Input Parameters
>
> **dealId** `integer` *required*
>
> The ID of the deal
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deals where a product is attached to
>
> **Slug:** `PIPEDRIVE_GET_DEALS_WITH_PRODUCT`
>
> Lists deals with a specified product attached, with status filtering and pagination. Archived deals are excluded by default.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **status** `string ("open" | "won" | "lost" | "deleted" | "all_not_deleted")`
>
> Only fetch deals with a specific status. If omitted, all not deleted deals are returned. If set to deleted, deals that have been deleted up to 30 days ago will be included.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get deal updates
>
> **Slug:** `PIPEDRIVE_GET_DEAL_UPDATES`
>
> Lists updates about a deal in chronological order. Use when you need to track deal changes, monitor activity timeline, or audit deal modifications.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique identifier of the deal
>
> **items** `string`
>
> Comma-separated filter for specific update types. Supported values: call, activity, plannedActivity, change, note, deal, file, dealChange, personChange, organizationChange, follower, dealFollower, personFollower, organizationFollower, participant, comment, mailMessage, mailMessageWithAttachment, invoice, document, marketing\_campaign\_stat, marketing\_status\_change. Note: Use 'change' instead of 'dealChange' for deal change items
>
> **limit** `integer`
>
> Number of items to show per page for pagination
>
> **start** `integer`
>
> Pagination starting point for retrieving results
>
> **all\_changes** `string`
>
> Set to "1" to display custom field updates in the response; omit to exclude custom field changes
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Deal Permitted Users
>
> **Slug:** `PIPEDRIVE_GET_DEAL_USERS`
>
> Tool to list users permitted to access a deal. Use when you need to retrieve all users who have permission to access a specific deal in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of an organization
>
> **Slug:** `PIPEDRIVE_GET_DETAILS_OF_AN_ORGANIZATION`
>
> Retrieves detailed information about an organization by ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of a person (Deprecated)
>
> **Slug:** `PIPEDRIVE_GET_DETAILS_OF_A_PERSON`
>
> Retrieves details of a person by ID. This tool is deprecated.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one file
>
> **Slug:** `PIPEDRIVE_GET_FILE`
>
> Returns data about a specific file.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the file
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one filter
>
> **Slug:** `PIPEDRIVE_GET_FILTER`
>
> Returns data about a specific filter. Note that this also returns the condition lines of the filter.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the filter
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get result of a goal
>
> **Slug:** `PIPEDRIVE_GET_GOAL_RESULT`
>
> Gets the progress of a goal for the specified period.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the goal that the results are looked for
>
> **period\_\_end** `string` *required*
>
> The end date of the period for which to find the goal"s progress. Format: YYYY-MM-DD. This date must be the same or before the goal duration end date.
>
> **period\_\_start** `string` *required*
>
> The start date of the period for which to find the goal"s progress. Format: YYYY-MM-DD. This date must be the same or after the goal duration start date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get lead conversion status by ID
>
> **Slug:** `PIPEDRIVE_GET_LEAD_CONVERSION_STATUS`
>
> Tool to retrieve the conversion status for a specific lead conversion job. Use when you need to check the progress of a lead-to-deal conversion including current state and resulting deal ID upon completion.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The identifier for a specific lead (UUID format)
>
> **conversion\_id** `string` *required*
>
> The identifier for the conversion job (UUID format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all lead fields
>
> **Slug:** `PIPEDRIVE_GET_LEAD_FIELDS`
>
> Tool to retrieve all lead fields. Use when you need to get the schema for leads in a company's context.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of items shown per page
>
> **start** `integer`
>
> Pagination start position
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Lead Permitted Users
>
> **Slug:** `PIPEDRIVE_GET_LEAD_USERS`
>
> Tool to list users permitted to access a lead. Use when you need to retrieve all user IDs who have permission to access a specific lead in Pipedrive.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the lead
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one mail message
>
> **Slug:** `PIPEDRIVE_GET_MAIL_MESSAGE`
>
> Returns data about a specific mail message.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the mail message to fetch
>
> **include\_body** `integer`
>
> Whether to include the full message body or not. `0` = Don"t include, `1` = Include.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one mail thread
>
> **Slug:** `PIPEDRIVE_GET_MAIL_THREAD`
>
> Returns a specific mail thread.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the mail thread
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all mail messages of mail thread
>
> **Slug:** `PIPEDRIVE_GET_MAIL_THREAD_MESSAGES`
>
> Returns all the mail messages inside a specified mail thread.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the mail thread
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get mail threads
>
> **Slug:** `PIPEDRIVE_GET_MAIL_THREADS`
>
> Returns mail threads in a specified folder ordered by the most recent message within.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **folder** `string ("inbox" | "drafts" | "sent" | "archive")` *required*
>
> The type of folder to fetch
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Marketplace Client ID
>
> **Slug:** `PIPEDRIVE_GET_MARKETPLACE_CLIENT_ID`
>
> Return a supplied marketplace client ID hint, or select an add-on code using an optional provider-name match. If no code is found, return a connection or consumer identifier or a test placeholder; the result is not necessarily an installed video integration's client ID.
>
> #### Input Parameters
>
> **provider** `string`
>
> Optional provider name to filter add-ons by code containing this string.
>
> **marketplace\_client\_id\_hint** `string`
>
> Hint for the marketplace client ID. If provided, returned immediately.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one note
>
> **Slug:** `PIPEDRIVE_GET_NOTE`
>
> Returns details about a specific note.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all comments for a note
>
> **Slug:** `PIPEDRIVE_GET_NOTE_COMMENTS`
>
> Lists comments associated with a note, with pagination.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one lead
>
> **Slug:** `PIPEDRIVE_GET_ONE_LEAD`
>
> Returns details about a specific lead by ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the lead
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Details
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION`
>
> Tool to get details of a specific organization in Pipedrive. Use when you need to retrieve comprehensive information about an organization by its ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization to retrieve
>
> **custom\_fields** `string`
>
> Comma-separated list of custom field keys to include (maximum 15 keys). Use this parameter for faster results and smaller responses when only specific custom fields are needed.
>
> **include\_fields** `string`
>
> Comma-separated list of additional fields to include in the response. Acceptable values: next\_activity\_id, last\_activity\_id, open\_deals\_count, related\_open\_deals\_count, closed\_deals\_count, related\_closed\_deals\_count, email\_messages\_count, people\_count, activities\_count, done\_activities\_count, undone\_activities\_count, files\_count, notes\_count, followers\_count, won\_deals\_count, related\_won\_deals\_count, lost\_deals\_count, related\_lost\_deals\_count
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Changelog
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_CHANGELOG`
>
> Tool to list updates about organization field values. Use when you need to retrieve the changelog history showing all changes made to a specific organization's field values.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **limit** `integer`
>
> Number of items to display per page. Controls the size of each paginated response. Maximum value is 500.
>
> **cursor** `string`
>
> Pagination cursor for the first item on the next page. Use the cursor returned in the response to fetch the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get organization deals
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_DEALS`
>
> Lists deals associated with an organization, with optional filtering and pagination. Archived deals are not returned.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **sort** `string`
>
> Field names and sorting mode separated by comma (e.g., 'add\_time ASC'). Only first-level field keys are supported (no nested keys).
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start. Default: 0
>
> **status** `string ("open" | "won" | "lost" | "deleted" | "all_not_deleted")`
>
> Filter by deal status. Values: open, won, lost, deleted, all\_not\_deleted. If omitted, all not deleted deals are returned.
>
> **only\_primary\_association** `integer`
>
> If set to 1, only deals directly associated to the organization are fetched. If not set (default), all deals are fetched that are either directly or indirectly related to the organization. Values: 0 or 1
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one organization field
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_FIELD`
>
> Tool to retrieve a specific organization field by ID. Use when you need to get metadata and configuration for an organization field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization field to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Files
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_FILES`
>
> Tool to list files attached to an organization. Use when you need to retrieve all files associated with a specific organization in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **sort** `string`
>
> Supported fields for sorting: `id`, `update_time`. Example: 'id ASC' or 'update\_time DESC'.
>
> **limit** `integer`
>
> Items shown per page. Maximum value of 100 is allowed.
>
> **start** `integer`
>
> Pagination start. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Followers
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_FOLLOWERS`
>
> Tool to list followers of an organization. Use when you need to retrieve all users who are following a specific organization in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Maximum value of 500 is allowed.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Followers Changelog
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_FOLLOWERS_CHANGELOG`
>
> Tool to list changelog about organization followers. Use when you need to retrieve the history of users who have followed or unfollowed a specific organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Maximum value of 500 is allowed.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Mail Messages
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_MAIL_MESSAGES`
>
> Tool to list mail messages associated with an organization. Use when you need to retrieve all email correspondence linked to a specific organization in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **limit** `integer`
>
> Number of items displayed per page (default: 100, max: 500)
>
> **start** `integer`
>
> Pagination start point. Default: 0
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Persons
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_PERSONS`
>
> Tool to list persons associated with an organization. Use when you need to retrieve all persons linked to a specific organization in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **limit** `integer`
>
> Number of items shown per page. Defines how many records to return in one request.
>
> **start** `integer`
>
> Pagination start position. Indicates from which record number to start returning results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one organization relationship
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_RELATIONSHIP`
>
> Finds and returns an organization relationship from its ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization relationship
>
> **org\_id** `integer`
>
> The ID of the base organization for the returned calculated values
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Organization Updates
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_UPDATES`
>
> Tool to list updates about an organization including field value changes, activities, notes, files, and other related items. Use when you need to retrieve the activity flow and update history for a specific organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **items** `string`
>
> A comma-separated string for filtering out item-specific updates. Possible values: activity, plannedActivity, note, file, change, deal, follower, participant, mailMessage, mailMessageWithAttachment, invoice, activityFile, document
>
> **limit** `integer`
>
> Items shown per page. Maximum value of 500 is allowed. If not provided, 100 items will be returned.
>
> **start** `integer`
>
> Pagination start point. Use to skip initial items and start from a specific position in the results.
>
> **all\_changes** `string`
>
> Whether to show custom field updates or not. Set to '1' to include custom field changes. If omitted, returns changes without custom field updates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get organization permitted users
>
> **Slug:** `PIPEDRIVE_GET_ORGANIZATION_USERS`
>
> List users permitted to access an organization. Use when you need to retrieve all users who have been granted permission to view and interact with a specific organization record.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one permission set
>
> **Slug:** `PIPEDRIVE_GET_PERMISSION_SET`
>
> Returns data about a specific permission set.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the permission set
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Permission Set Assignments
>
> **Slug:** `PIPEDRIVE_GET_PERMISSION_SET_ASSIGNMENTS`
>
> Tool to list permission set assignments for a given permission set. Use when you need to retrieve all users assigned to a specific permission set.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the permission set
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start (default: 0)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Person Details
>
> **Slug:** `PIPEDRIVE_GET_PERSON`
>
> Tool to get details of a specific person in Pipedrive. Use when you need to retrieve comprehensive information about a person by their ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person to retrieve
>
> **custom\_fields** `string`
>
> Comma-separated list of custom field keys to include (maximum 15 keys). Use this parameter for faster results and smaller responses when only specific custom fields are needed.
>
> **include\_fields** `string`
>
> Comma-separated list of additional fields to include in the response. Allowed values: next\_activity\_id, last\_activity\_id, open\_deals\_count, related\_open\_deals\_count, closed\_deals\_count, related\_closed\_deals\_count, participant\_open\_deals\_count, participant\_closed\_deals\_count, email\_messages\_count, activities\_count, done\_activities\_count, undone\_activities\_count, files\_count, notes\_count, followers\_count, won\_deals\_count, related\_won\_deals\_count, lost\_deals\_count, related\_lost\_deals\_count, last\_incoming\_mail\_time, last\_outgoing\_mail\_time, marketing\_status, doi\_status. Note: marketing\_status and doi\_status are only available if company has marketing app enabled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Person Changelog
>
> **Slug:** `PIPEDRIVE_GET_PERSON_CHANGELOG`
>
> Tool to list updates about person field values. Use when you need to retrieve the changelog history showing all changes made to a specific person's field values.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **limit** `integer`
>
> Number of items to display per page. Controls the size of each paginated response.
>
> **cursor** `string`
>
> Pagination cursor for the first item on the next page. Use the cursor returned in the response to fetch the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get person deals
>
> **Slug:** `PIPEDRIVE_GET_PERSON_DEALS`
>
> Lists deals associated with a person, excluding archived deals by default. The API v1 endpoint used is out of support and may be changed or removed without notice.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **sort** `string`
>
> Field names and sorting mode separated by comma (e.g., 'field\_name\_1 ASC', 'field\_name\_2 DESC'). Only first-level field keys are supported.
>
> **limit** `integer`
>
> Number of items shown per page
>
> **start** `integer`
>
> Pagination start position
>
> **status** `string`
>
> Filter deals by status. Allowed values: 'open', 'won', 'lost', 'deleted', 'all\_not\_deleted'. Default is 'all\_not\_deleted'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one person field
>
> **Slug:** `PIPEDRIVE_GET_PERSON_FIELD`
>
> Tool to retrieve metadata for a specific person field by its ID. Use when you need to get field properties like name, type, order, and options.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Person Files
>
> **Slug:** `PIPEDRIVE_GET_PERSON_FILES`
>
> Tool to list files attached to a person. Use when you need to retrieve all files associated with a specific person in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **sort** `string`
>
> Field to sort by. Supported fields: `id`, `update_time`.
>
> **limit** `integer`
>
> Items shown per page. Maximum value of 100 is allowed.
>
> **start** `integer`
>
> Pagination start. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Person Followers
>
> **Slug:** `PIPEDRIVE_GET_PERSON_FOLLOWERS`
>
> Tool to list followers of a person in Pipedrive. Use when you need to retrieve all users who are following a specific person.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Maximum value allowed is 500.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get person followers changelog
>
> **Slug:** `PIPEDRIVE_GET_PERSON_FOLLOWERS_CHANGELOG`
>
> Tool to retrieve changelogs about users who have followed a person. Use when you need to track follower activity, showing when users were added or removed as followers.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Person Mail Messages
>
> **Slug:** `PIPEDRIVE_GET_PERSON_MAIL_MESSAGES`
>
> Tool to list mail messages associated with a person in Pipedrive. Use when you need to retrieve email communications linked to a specific person contact.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **limit** `integer`
>
> Number of items shown per page. If not specified, all items are returned.
>
> **start** `integer`
>
> Pagination start position. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Person Picture
>
> **Slug:** `PIPEDRIVE_GET_PERSON_PICTURE`
>
> Tool to get picture details of a specific person in Pipedrive. Use when you need to retrieve picture information and URLs for a person by their ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person whose picture to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Person Products
>
> **Slug:** `PIPEDRIVE_GET_PERSON_PRODUCTS`
>
> Tool to list products associated with a person. Use when you need to retrieve all products linked to a specific person in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **limit** `integer`
>
> Items shown per page. If not provided, the default limit from API settings will be used.
>
> **start** `integer`
>
> Pagination start position
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get person updates
>
> **Slug:** `PIPEDRIVE_GET_PERSON_UPDATES`
>
> Lists updates and activity history for a specific person in chronological order. Use when you need to track person changes, monitor activity timeline, or audit person modifications.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person whose updates should be retrieved
>
> **items** `string`
>
> Comma-separated string for filtering specific update types. Possible values: call, activity, plannedActivity, change, note, deal, file, dealChange, personChange, organizationChange, follower, dealFollower, personFollower, organizationFollower, participant, comment, mailMessage, mailMessageWithAttachment, invoice, document, marketing\_campaign\_stat, marketing\_status\_change
>
> **limit** `integer`
>
> Items shown per page for pagination
>
> **start** `integer`
>
> Pagination start position. Default is 0.
>
> **all\_changes** `string`
>
> Set to "1" to include custom field updates in the response. If omitted, returns changes without custom field updates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Person Permitted Users
>
> **Slug:** `PIPEDRIVE_GET_PERSON_USERS`
>
> Tool to list users permitted to access a person. Use when you need to retrieve all users who have permission to access a specific person in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one pipeline
>
> **Slug:** `PIPEDRIVE_GET_PIPELINE`
>
> Returns data about a specific pipeline.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the pipeline
>
> **totals\_convert\_currency** `string`
>
> The 3-letter currency code of any of the supported currencies. When supplied, `per_stages_converted` is returned in `deals_summary` which contains the currency-converted total amounts in the given currency per each stage. You may also set this parameter to `default_currency` in which case users default currency is used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Pipeline Conversion Statistics
>
> **Slug:** `PIPEDRIVE_GET_PIPELINE_CONVERSION_STATISTICS`
>
> Tool to get deals conversion rates in a pipeline for a given time period. Use when you need stage-to-stage conversion statistics, won conversion rates, or lost conversion rates for a specific pipeline.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the pipeline
>
> **user\_id** `integer`
>
> The ID of the user who's pipeline metrics statistics to fetch. If omitted, the authorized user will be used
>
> **end\_date** `string` *required*
>
> The end of the period. Date in format of YYYY-MM-DD
>
> **start\_date** `string` *required*
>
> The start of the period. Date in format of YYYY-MM-DD
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Pipeline Movement Statistics
>
> **Slug:** `PIPEDRIVE_GET_PIPELINE_MOVEMENT_STATISTICS`
>
> Tool to retrieve deal movement statistics within a pipeline for a specified time period. Use when you need to analyze pipeline performance metrics including new deals, won/lost deals, deals left open, and average age statistics.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The pipeline's identifier
>
> **user\_id** `integer`
>
> Specifies which team member's statistics to retrieve; if absent, the authorized user's data is used
>
> **end\_date** `string` *required*
>
> Period end date in YYYY-MM-DD format
>
> **start\_date** `string` *required*
>
> Period beginning date in YYYY-MM-DD format
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one product
>
> **Slug:** `PIPEDRIVE_GET_PRODUCT`
>
> Returns data about a specific product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Product Deals
>
> **Slug:** `PIPEDRIVE_GET_PRODUCT_DEALS`
>
> Lists deals associated with a product, excluding archived deals by default. Supports pagination and filtering by deal status.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **limit** `integer`
>
> Items shown per page. Maximum value allowed is 500.
>
> **start** `integer`
>
> Pagination start. Default is 0.
>
> **status** `string`
>
> Filter deals by status. Options: 'open', 'won', 'lost', 'deleted', 'all\_not\_deleted'. Default is 'all\_not\_deleted'. If set to 'deleted', deals deleted up to 30 days ago will be included.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one product field
>
> **Slug:** `PIPEDRIVE_GET_PRODUCT_FIELD`
>
> Returns data about a specific product field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Product Files
>
> **Slug:** `PIPEDRIVE_GET_PRODUCT_FILES`
>
> Tool to list files attached to a product. Use when you need to retrieve all files associated with a specific product in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **sort** `string`
>
> Field names and sorting mode separated by comma (field\_name\_1 ASC, field\_name\_2 DESC). Supported fields: `id`, `update_time`. Only first field is used for sorting.
>
> **limit** `integer`
>
> Number of items per page. Maximum value of 100 is allowed.
>
> **start** `integer`
>
> Pagination start offset. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get product followers
>
> **Slug:** `PIPEDRIVE_GET_PRODUCT_FOLLOWERS`
>
> Tool to list all followers of a product in Pipedrive. Use when you need to retrieve users following a specific product. Returns pagination metadata to handle large follower lists.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Maximum value: 500
>
> **start** `integer`
>
> Pagination start offset for entries. Default is 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Product Followers Changelog
>
> **Slug:** `PIPEDRIVE_GET_PRODUCT_FOLLOWERS_CHANGELOG`
>
> Tool to list changelog of followers for a product. Use when you need to retrieve the history of users who have followed or unfollowed a specific product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Maximum value of 500 is allowed.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get product images
>
> **Slug:** `PIPEDRIVE_GET_PRODUCT_IMAGES`
>
> Tool to retrieve image data for a specific product. Use when you need to get the public URL and metadata for a product's image. Note that public URLs have a limited lifetime of 7 days.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List permitted users for product
>
> **Slug:** `PIPEDRIVE_GET_PRODUCT_USERS`
>
> Tool to list users permitted to access a product in Pipedrive. Use when you need to retrieve the list of users who have permission to view or manage a specific product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product to get permitted users for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get product variations
>
> **Slug:** `PIPEDRIVE_GET_PRODUCT_VARIATIONS`
>
> Retrieve a page of variations for a specific product, including available prices across currencies. Use the returned cursor to request subsequent pages.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **limit** `integer`
>
> For pagination, the maximum entries returned. Default is 100; maximum allowed is 500
>
> **cursor** `string`
>
> For pagination, an opaque marker representing the first item on the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of a project
>
> **Slug:** `PIPEDRIVE_GET_PROJECT`
>
> Retrieves a project by ID; custom field hashes in the returned project data can be matched to project field keys. API errors may be returned in the response data.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Returns project activities
>
> **Slug:** `PIPEDRIVE_GET_PROJECT_ACTIVITIES`
>
> Returns activities linked to a specific project.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of a board
>
> **Slug:** `PIPEDRIVE_GET_PROJECT_BOARD`
>
> Returns the details of a specific project board.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project board
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Returns project groups
>
> **Slug:** `PIPEDRIVE_GET_PROJECT_GROUPS`
>
> Returns all active groups under a specific project.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of a phase
>
> **Slug:** `PIPEDRIVE_GET_PROJECT_PHASE`
>
> Retrieves a project phase by ID. API error payloads can also be returned in the response data.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project phase
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project phases
>
> **Slug:** `PIPEDRIVE_GET_PROJECT_PHASES`
>
> Returns all active project phases under a specific board.
>
> #### Input Parameters
>
> **board\_id** `integer` *required*
>
> ID of the board for which phases are requested
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Returns project plan
>
> **Slug:** `PIPEDRIVE_GET_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.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Returns project tasks
>
> **Slug:** `PIPEDRIVE_GET_PROJECT_TASKS`
>
> Returns tasks linked to a specific project.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get recents
>
> **Slug:** `PIPEDRIVE_GET_RECENTS`
>
> Returns data about all recent changes occurred after the given timestamp.
>
> #### Input Parameters
>
> **items** `string ("activity" | "activityType" | "deal" | "file" | "filter" | "note" | "person" | "organization" | "pipeline" | "product" | "stage" | "user")`
>
> Multiple selection of item types to include in the query (optional)
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **since\_timestamp** `string` *required*
>
> The timestamp in UTC. Format: YYYY-MM-DD HH:MM:SS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one role
>
> **Slug:** `PIPEDRIVE_GET_ROLE`
>
> Tool to retrieve details for a specific role by its ID. Use when you need to get complete role information including name, parent role, active status, assignment count, and default visibility settings.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get role assignments
>
> **Slug:** `PIPEDRIVE_GET_ROLE_ASSIGNMENTS`
>
> List a page of user assignments for a specific role in Pipedrive, with pagination support.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **limit** `integer`
>
> Number of items shown per page
>
> **start** `integer`
>
> Pagination start position
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get role pipelines
>
> **Slug:** `PIPEDRIVE_GET_ROLE_PIPELINES`
>
> Returns the visibility settings for pipelines associated with a specific role. Use when you need to list which pipelines are visible or hidden for a role.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **visible** `boolean`
>
> Determines whether to retrieve visible or hidden pipelines. Defaults to true (visible pipelines).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get role settings
>
> **Slug:** `PIPEDRIVE_GET_ROLE_SETTINGS`
>
> Tool to retrieve visibility settings of a specific role. Use when you need to get default visibility levels and access levels for deals, leads, organizations, people, and products associated with a role. Note: - Roles endpoints require the `admin` scope. - For OAuth tokens, Pipedrive expects the company domain base URL with `/api/v1` path. Example: https\://\{COMPANY}.pipedrive.com/api/v1/roles/\{id}/settings - This action normalizes the provided base\_url to use `/api/v1` to avoid host/path mismatches.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one stage
>
> **Slug:** `PIPEDRIVE_GET_STAGE`
>
> Returns data about a specific stage.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the stage
>
> **everyone** `integer`
>
> If `everyone=1` is provided, deals summary will return deals owned by every user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of a subscription
>
> **Slug:** `PIPEDRIVE_GET_SUBSCRIPTION`
>
> Retrieves an installment or recurring subscription by ID. The result may instead contain installments or products for a deal with the same ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the subscription
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all payments of a subscription
>
> **Slug:** `PIPEDRIVE_GET_SUBSCRIPTION_PAYMENTS`
>
> Retrieves payments for an installment or recurring subscription by subscription ID. An empty result does not necessarily mean the subscription has no payments.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the subscription
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of a task
>
> **Slug:** `PIPEDRIVE_GET_TASK`
>
> Returns the details of a specific task.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the task
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a single team
>
> **Slug:** `PIPEDRIVE_GET_TEAM`
>
> Returns data about a specific team.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the team
>
> **skip\_users** `integer`
>
> When enabled, the teams will not include IDs of member users
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of a template
>
> **Slug:** `PIPEDRIVE_GET_TEMPLATE`
>
> Retrieves a project template by ID. API errors may be returned in the response data.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project template
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get templates for a channel
>
> **Slug:** `PIPEDRIVE_GET_TEMPLATES`
>
> Tool to retrieve message templates for a channel. Use when template support is enabled.
>
> #### Input Parameters
>
> **channel\_id** `string` *required*
>
> Unique ID of the messaging channel (UUID format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get one user
>
> **Slug:** `PIPEDRIVE_GET_USER`
>
> Returns data about a specific user within the company.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all call logs assigned to a particular user
>
> **Slug:** `PIPEDRIVE_GET_USER_CALL_LOGS`
>
> Returns all call logs assigned to a particular user.
>
> #### Input Parameters
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. The upper limit is 50.
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Followers
>
> **Slug:** `PIPEDRIVE_GET_USER_FOLLOWERS`
>
> List a page of users following a specific Pipedrive user. Use the returned cursor to request subsequent pages.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> **limit** `integer`
>
> For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Maximum value of 500 is allowed.
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List user permissions
>
> **Slug:** `PIPEDRIVE_GET_USER_PERMISSIONS`
>
> Tool to list aggregated permissions over all assigned permission sets for a user. Use when you need to check what capabilities and access rights a specific user has across the system.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The identifier of the user whose permissions to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Role Assignments
>
> **Slug:** `PIPEDRIVE_GET_USER_ROLE_ASSIGNMENTS`
>
> List a page of role assignments for a specific Pipedrive user, with pagination support.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start position
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user role settings
>
> **Slug:** `PIPEDRIVE_GET_USER_ROLE_SETTINGS`
>
> Tool to list user role settings. Use when you need to retrieve the role configuration data for a specific user, including default visibility levels and access levels for various entities. Note: This endpoint costs 10 API credits per request.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Link a remote file to an item
>
> **Slug:** `PIPEDRIVE_LINK_REMOTE_FILE`
>
> 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](https://pipedrive.readme.io/docs/adding-a-remote-file)" target="\_blank" rel="noopener noreferrer">adding a remote file\</a>.
>
> #### Input Parameters
>
> **item\_id** `integer` *required*
>
> The ID of the item to associate the file with
>
> **item\_type** `string ("deal" | "organization" | "person")` *required*
>
> The item type
>
> **remote\_id** `string` *required*
>
> The remote item ID
>
> **remote\_location** `string ("googledrive")` *required*
>
> The location type to send the file to. Only `googledrive` is supported at the moment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Link User Video Integration
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **user\_id** `integer` *required*
>
> Pipedrive user ID
>
> **company\_id** `integer` *required*
>
> Pipedrive company ID
>
> **user\_provider\_id** `string` *required*
>
> Unique identifier linking a user to the installed integration. Generated by the integration.
>
> **marketplace\_client\_id** `string` *required*
>
> Pipedrive Marketplace client ID of the installed integration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List activities
>
> **Slug:** `PIPEDRIVE_LIST_ACTIVITIES`
>
> List activities, or select up to 100 IDs, with relationship and completion filters and cursor pagination.
>
> #### Input Parameters
>
> **ids** `array`
>
> Activity IDs to return, with at most 100 IDs per request.
>
> **done** `boolean`
>
> Whether to return completed or incomplete activities.
>
> **limit** `integer`
>
> Maximum number of activities to return.
>
> **cursor** `string`
>
> Opaque cursor identifying the next page to return.
>
> **org\_id** `integer`
>
> The ID of the organization linked to the activities.
>
> **deal\_id** `integer`
>
> The ID of the deal linked to the activities.
>
> **lead\_id** `string`
>
> The UUID of the lead linked to the activities.
>
> **sort\_by** `string ("id" | "update_time" | "add_time" | "due_date")`
>
> Field used to sort the activities.
>
> **owner\_id** `integer`
>
> The ID of the user who owns the activities.
>
> **filter\_id** `integer`
>
> The ID of the filter to apply.
>
> **person\_id** `integer`
>
> The ID of the person linked to the activities.
>
> **updated\_since** `string`
>
> Return activities updated at or after this ISO 8601 timestamp.
>
> **updated\_until** `string`
>
> Return activities updated before this ISO 8601 timestamp.
>
> **include\_fields** `array`
>
> Additional activity fields to include in the response.
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Direction used to sort the activities.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List activities associated with a deal
>
> **Slug:** `PIPEDRIVE_LIST_DEAL_ACTIVITIES`
>
> Lists activities associated with a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **done** `integer`
>
> Whether the activity is done or not. 0 = Not done, 1 = Done. If omitted, returns both Done and Not done activities.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **exclude** `string`
>
> A comma-separated string of activity IDs to exclude from result
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List files attached to a deal
>
> **Slug:** `PIPEDRIVE_LIST_DEAL_FILES`
>
> Lists files associated with a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys). Supported fields: `id`, `user_id`, `deal_id`, `person_id`, `org_id`, `product_id`, `add_time`, `update_time`, `file_name`, `file_type`, `file_size`, `comment`.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List followers of a deal
>
> **Slug:** `PIPEDRIVE_LIST_DEAL_FOLLOWERS`
>
> Lists the followers of a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List mail messages associated with a deal
>
> **Slug:** `PIPEDRIVE_LIST_DEAL_MAIL_MESSAGES`
>
> Lists mail messages associated with a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all persons associated with a deal
>
> **Slug:** `PIPEDRIVE_LIST_DEAL_PERSONS`
>
> 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.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List products attached to a deal
>
> **Slug:** `PIPEDRIVE_LIST_DEAL_PRODUCTS`
>
> Lists products attached to a Pipedrive deal, with pagination and an option to include product data. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use GET /api/v2/deals/\{id}/products instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **include\_product\_data** `integer`
>
> Whether to fetch product data along with each attached product (1) or not (0, default)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List deals
>
> **Slug:** `PIPEDRIVE_LIST_DEALS`
>
> List non-archived deals with relationship and status filters, selected custom fields, and cursor pagination.
>
> #### Input Parameters
>
> **ids** `array`
>
> Deal IDs to return, with at most 100 IDs per request.
>
> **limit** `integer`
>
> Maximum number of deals to return (1-500).
>
> **cursor** `string`
>
> Opaque cursor returned by the previous page.
>
> **org\_id** `integer`
>
> Return deals linked to this organization ID.
>
> **status** `array`
>
> Deal statuses to return: open, won, lost, or deleted.
>
> **sort\_by** `string ("id" | "update_time" | "add_time")`
>
> Field used to sort deals.
>
> **owner\_id** `integer`
>
> Return deals owned by this user ID.
>
> **stage\_id** `integer`
>
> Return deals in this stage ID.
>
> **filter\_id** `integer`
>
> ID of the filter to apply.
>
> **person\_id** `integer`
>
> Return deals linked to this person ID.
>
> **pipeline\_id** `integer`
>
> Return deals in this pipeline ID.
>
> **custom\_fields** `array`
>
> Custom field keys to include, with at most 15 keys per request.
>
> **updated\_since** `string`
>
> Return deals updated at or after this RFC 3339 timestamp.
>
> **updated\_until** `string`
>
> Return deals updated before this RFC 3339 timestamp.
>
> **include\_fields** `array`
>
> Additional deal fields to include in each result.
>
> **include\_labels** `boolean`
>
> Whether to include deal label details.
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Direction used to sort deals.
>
> **include\_option\_labels** `boolean`
>
> Whether to include labels for custom-field options.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List updates about a deal
>
> **Slug:** `PIPEDRIVE_LIST_DEAL_UPDATES`
>
> Lists updates about a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **items** `string`
>
> A comma-separated string for filtering out item specific updates. (Possible values - call, activity, plannedActivity, change, note, deal, file, dealChange, personChange, organizationChange, follower, dealFollower, personFollower, organizationFollower, participant, comment, mailMessage, mailMessageWithAttachment, invoice, document, marketing\_campaign\_stat, marketing\_status\_change).
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **all\_changes** `string`
>
> Whether to show custom field updates or not. 1 = Include custom field changes. If omitted returns changes without custom field updates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List permitted users
>
> **Slug:** `PIPEDRIVE_LIST_DEAL_USERS`
>
> Lists the users permitted to access a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all files
>
> **Slug:** `PIPEDRIVE_LIST_FILES`
>
> Lists a page of files across Pipedrive, regardless of the entity they are attached to, with pagination and sorting options.
>
> #### Input Parameters
>
> **sort** `string`
>
> Field names and sorting mode separated by a comma. Supported fields: `id`, `update_time`. Example: 'id ASC' or 'update\_time DESC'.
>
> **limit** `integer`
>
> Number of items shown per page. Maximum value of 100 is allowed.
>
> **start** `integer`
>
> Pagination start position. Defaults to 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List activities associated with an organization
>
> **Slug:** `PIPEDRIVE_LIST_ORGANIZATION_ACTIVITIES`
>
> Lists activities associated with an organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **done** `integer`
>
> Whether the activity is done or not. 0 = Not done, 1 = Done. If omitted returns both Done and Not done activities.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **exclude** `string`
>
> A comma-separated string of activity IDs to exclude from result
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List deals associated with an organization
>
> **Slug:** `PIPEDRIVE_LIST_ORGANIZATION_DEALS`
>
> Lists non-archived deals associated with an organization, with status filtering and pagination.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys).
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **status** `string ("open" | "won" | "lost" | "deleted" | "all_not_deleted")`
>
> Only fetch deals with a specific status. If omitted, all not deleted deals are returned. If set to deleted, deals that have been deleted up to 30 days ago will be included.
>
> **only\_primary\_association** `integer`
>
> If set, only deals that are directly associated to the organization are fetched. If not set (default), all deals are fetched that are either directly or indirectly related to the organization. Indirect relations include relations through custom, organization-type fields and through persons of the given organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List files attached to an organization
>
> **Slug:** `PIPEDRIVE_LIST_ORGANIZATION_FILES`
>
> Lists files associated with an organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys). Supported fields: `id`, `user_id`, `deal_id`, `person_id`, `org_id`, `product_id`, `add_time`, `update_time`, `file_name`, `file_type`, `file_size`, `comment`.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List followers of an organization
>
> **Slug:** `PIPEDRIVE_LIST_ORGANIZATION_FOLLOWERS`
>
> Lists the followers of an organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List mail messages associated with an organization
>
> **Slug:** `PIPEDRIVE_LIST_ORGANIZATION_MAIL_MESSAGES`
>
> Lists mail messages associated with an organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List persons of an organization
>
> **Slug:** `PIPEDRIVE_LIST_ORGANIZATION_PERSONS`
>
> Lists persons associated with an organization.\
> 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_status` field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List participants of a deal
>
> **Slug:** `PIPEDRIVE_LIST_PARTICIPANTS_OF_A_DEAL`
>
> Lists the participants associated with a deal.\
> 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_status` field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List permission set assignments
>
> **Slug:** `PIPEDRIVE_LIST_PERMISSION_SET_ASSIGNMENTS`
>
> Returns the list of assignments for a permission set. Notes: - This endpoint requires the `admin` OAuth scope. - OAuth calls must target the company domain with `/api/v1` path, e.g., https\://\{COMPANY}.pipedrive.com/api/v1/permissionSets/\{id}/assignments - This action normalizes the base URL accordingly and returns the API envelope even on errors.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the permission set
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List activities associated with a person
>
> **Slug:** `PIPEDRIVE_LIST_PERSON_ACTIVITIES`
>
> Lists activities associated with a person.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **done** `integer`
>
> Whether the activity is done or not. 0 = Not done, 1 = Done. If omitted, returns both Done and Not done activities.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **exclude** `string`
>
> A comma-separated string of activity IDs to exclude from result
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List deals associated with a person
>
> **Slug:** `PIPEDRIVE_LIST_PERSON_DEALS`
>
> Lists non-archived deals associated with a person, with status filtering and pagination.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys).
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **status** `string ("open" | "won" | "lost" | "deleted" | "all_not_deleted")`
>
> Only fetch deals with a specific status. If omitted, all not deleted deals are returned. If set to deleted, deals that have been deleted up to 30 days ago will be included.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List files attached to a person
>
> **Slug:** `PIPEDRIVE_LIST_PERSON_FILES`
>
> Lists files associated with a person.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **sort** `string`
>
> The field names and sorting mode separated by a comma (`field_name_1 ASC`, `field_name_2 DESC`). Only first-level field keys are supported (no nested keys). Supported fields: `id`, `user_id`, `deal_id`, `person_id`, `org_id`, `product_id`, `add_time`, `update_time`, `file_name`, `file_type`, `file_size`, `comment`.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List followers of a person
>
> **Slug:** `PIPEDRIVE_LIST_PERSON_FOLLOWERS`
>
> Lists the followers of a person.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List mail messages associated with a person
>
> **Slug:** `PIPEDRIVE_LIST_PERSON_MAIL_MESSAGES`
>
> Lists mail messages associated with a person.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List products associated with a person
>
> **Slug:** `PIPEDRIVE_LIST_PERSON_PRODUCTS`
>
> Lists products associated with a person.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List persons
>
> **Slug:** `PIPEDRIVE_LIST_PERSONS`
>
> List persons, or select up to 100 IDs, with relationship filters, selected custom fields, and cursor pagination.
>
> #### Input Parameters
>
> **ids** `array`
>
> IDs of up to 100 persons to return.
>
> **limit** `integer`
>
> Maximum number of persons to return (1-500).
>
> **cursor** `string`
>
> Cursor returned by the previous page.
>
> **org\_id** `integer`
>
> Return persons linked to this organization ID.
>
> **deal\_id** `integer`
>
> Return persons linked to this deal ID.
>
> **sort\_by** `string ("id" | "update_time" | "add_time")`
>
> Field used to sort the persons.
>
> **owner\_id** `integer`
>
> Return persons owned by this user ID.
>
> **filter\_id** `integer`
>
> ID of the filter to use.
>
> **custom\_fields** `array`
>
> Keys of up to 15 custom fields to include.
>
> **updated\_since** `string`
>
> Return persons updated after this RFC 3339 timestamp.
>
> **updated\_until** `string`
>
> Return persons updated before this RFC 3339 timestamp.
>
> **include\_fields** `array`
>
> Additional person fields to include. Marketing status fields require the Campaigns product.
>
> **include\_labels** `boolean`
>
> Whether to include person label details.
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Direction used to sort the persons.
>
> **include\_option\_labels** `boolean`
>
> Whether to include human-readable custom field option labels.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Person Access Users
>
> **Slug:** `PIPEDRIVE_LIST_PERSON_USERS`
>
> List users permitted to access a person.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List files attached to a product
>
> **Slug:** `PIPEDRIVE_LIST_PRODUCT_FILES`
>
> Lists files associated with a product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **sort** `string`
>
> The field name and sorting mode (`field_name_1 ASC` or `field_name_1 DESC`). Supported fields: `update_time`, `id`.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List followers of a product
>
> **Slug:** `PIPEDRIVE_LIST_PRODUCT_FOLLOWERS`
>
> Lists the followers of a product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Product Permitted Users
>
> **Slug:** `PIPEDRIVE_LIST_PRODUCT_USERS`
>
> Lists users permitted to access a product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List role assignments
>
> **Slug:** `PIPEDRIVE_LIST_ROLE_ASSIGNMENTS`
>
> Lists users assigned to a role, with pagination. The action declares the admin OAuth scope.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List pipeline visibility for a role
>
> **Slug:** `PIPEDRIVE_LIST_ROLE_PIPELINE_VISIBILITY`
>
> Returns a list of visible or hidden pipeline IDs by role. See the "Visibility groups article" for details on pipeline visibility.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **visible** `boolean`
>
> Whether to return the visible or hidden pipelines for the role
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List role settings
>
> **Slug:** `PIPEDRIVE_LIST_ROLE_SETTINGS`
>
> Returns the visibility settings of a specific role. Notes: - Roles endpoints require the `admin` OAuth scope. - OAuth calls must target the company domain with `/api/v1` path, e.g., https\://\{COMPANY}.pipedrive.com/api/v1/roles/\{id}/settings - This action normalizes the base URL accordingly.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List updates about an organization
>
> **Slug:** `PIPEDRIVE_LIST_UPDATES_ABOUT_AN_ORGANIZATION`
>
> Lists updates about an organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **items** `string`
>
> A comma-separated string for filtering out item specific updates. (Possible values - activity, plannedActivity, note, file, change, deal, follower, participant, mailMessage, mailMessageWithAttachment, invoice, activityFile, document).
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **all\_changes** `string`
>
> Whether to show custom field updates or not. 1 = Include custom field changes. If omitted, returns changes without custom field updates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List updates about a person
>
> **Slug:** `PIPEDRIVE_LIST_UPDATES_ABOUT_A_PERSON`
>
> Lists updates about a person.\
> 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 `marketing_status` field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **items** `string`
>
> A comma-separated string for filtering out item specific updates. (Possible values - call, activity, plannedActivity, change, note, deal, file, dealChange, personChange, organizationChange, follower, dealFollower, personFollower, organizationFollower, participant, comment, mailMessage, mailMessageWithAttachment, invoice, document, marketing\_campaign\_stat, marketing\_status\_change).
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **all\_changes** `string`
>
> Whether to show custom field updates or not. 1 = Include custom field changes. If omitted returns changes without custom field updates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List updates about participants of a deal
>
> **Slug:** `PIPEDRIVE_LIST_UPDATES_ABOUT_PARTICIPANTS_OF_A_DEAL`
>
> This endpoint provides cursor-paginated updates on deal participants. For pagination details, see the Pipedrive documentation.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **limit** `integer`
>
> Items shown per page
>
> **cursor** `string`
>
> For pagination, the marker (an opaque string value) representing the first item on the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List followers of a user
>
> **Slug:** `PIPEDRIVE_LIST_USER_FOLLOWERS`
>
> Lists the followers of a specific user.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List user permissions
>
> **Slug:** `PIPEDRIVE_LIST_USER_PERMISSIONS`
>
> Lists aggregated permissions over all assigned permission sets for a user.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List User Role Assignments
>
> **Slug:** `PIPEDRIVE_LIST_USER_ROLE_ASSIGNMENTS`
>
> Lists role assignments for a user.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List user role settings
>
> **Slug:** `PIPEDRIVE_LIST_USER_ROLE_SETTINGS`
>
> Lists the settings of user's assigned role.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List settings of an authorized user
>
> **Slug:** `PIPEDRIVE_LIST_USER_SETTINGS`
>
> Lists the settings of an authorized user. Example response contains a shortened list of settings.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Merge Deals
>
> **Slug:** `PIPEDRIVE_MERGE_DEALS`
>
> Tool to merge two deals in Pipedrive. Use when you need to consolidate two deals into one. The deal specified by 'id' will be merged into the deal specified by 'merge\_with\_id', and the first deal will be removed while the second one will remain with all consolidated data.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal that will be merged and removed from the account
>
> **merge\_with\_id** `integer` *required*
>
> The ID of the deal that will remain in the account and receive the merged data. This deal takes priority in conflict scenarios, and all related data (activities, emails, notes, products, followers, participants, filters) will be transferred to it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Merge Organizations
>
> **Slug:** `PIPEDRIVE_MERGE_ORGANIZATIONS`
>
> Tool to merge two organizations in Pipedrive. Use when you need to consolidate two organizations into one. The organization specified by 'id' will be merged into the organization specified by 'merge\_with\_id', and the first organization will be removed while the second one will remain with all consolidated data.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization that will be merged and removed from the account
>
> **merge\_with\_id** `integer` *required*
>
> The ID of the organization that will remain in the account and receive the merged data. This organization takes priority in conflict scenarios.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Merge two persons
>
> **Slug:** `PIPEDRIVE_MERGE_PERSONS`
>
> Tool to merge two persons in Pipedrive. Use when you need to combine two person records into one. The person ID specified in the request will be merged and removed, while the merge\_with\_id person will remain. When data conflicts exist, the merge\_with\_id person's field data takes priority.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person that will be merged and removed from Pipedrive
>
> **merge\_with\_id** `integer` *required*
>
> The ID of the person that will remain after the merge. This person's data will be prioritized in case of conflict with the other person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Merge two deals
>
> **Slug:** `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](https://pipedrive.readme.io/docs/merging-two-deals)" target="\_blank" rel="noopener noreferrer">merging two deals\</a>.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **merge\_with\_id** `integer` *required*
>
> The ID of the deal that the deal will be merged with
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Merge two organizations
>
> **Slug:** `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](https://pipedrive.readme.io/docs/merging-two-organizations)" target="\_blank" rel="noopener noreferrer">merging two organizations\</a>.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **merge\_with\_id** `integer` *required*
>
> The ID of the organization that the organization will be merged with
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Merge two persons
>
> **Slug:** `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](https://pipedrive.readme.io/docs/merging-two-persons)" target="\_blank" rel="noopener noreferrer">merging two persons\</a>.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **merge\_with\_id** `integer` *required*
>
> The ID of the person that will not be overwritten. This person’s data will be prioritized in case of conflict with the other person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Organization accessible user list
>
> **Slug:** `PIPEDRIVE_ORGANIZATION_ACCESSIBLE_USER_LIST`
>
> List users permitted to access an organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch deal fields
>
> **Slug:** `PIPEDRIVE_PATCH_DEAL_FIELDS`
>
> Updates an existing deal custom field using PATCH method. Use when you need to modify field properties like name, visibility, or validation rules. Note that field code and type are immutable and cannot be changed.
>
> #### Input Parameters
>
> **field\_code** `string` *required*
>
> The unique code identifying the field (40-character identifier for custom fields)
>
> **field\_name** `string`
>
> The name displayed for the field. At least one body parameter must be provided.
>
> **description** `string`
>
> Text describing the field's purpose
>
> **ui\_visibility** `object`
>
> Settings controlling where the field appears in the web UI
>
> **required\_fields** `object`
>
> Settings for marking as mandatory at certain stages
>
> **important\_fields** `object`
>
> Configuration for highlighting at specific stages
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update organization field (v2)
>
> **Slug:** `PIPEDRIVE_PATCH_ORGANIZATION_FIELDS`
>
> Tool to update an existing organization field in Pipedrive using the v2 API. Use when you need to modify field name, UI visibility, importance settings, required field settings, or description.
>
> #### Input Parameters
>
> **field\_code** `string` *required*
>
> The unique code identifying the organization field to update
>
> **field\_name** `string`
>
> The new label/name for the organization field
>
> **description** `string`
>
> Description text for the field (nullable)
>
> **ui\_visibility** `object`
>
> Configuration for UI visibility settings
>
> **required\_fields** `object`
>
> Configuration for making field required
>
> **important\_fields** `object`
>
> Configuration for marking field as important
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Person Field Configuration
>
> **Slug:** `PIPEDRIVE_PATCH_PERSON_FIELDS`
>
> Tool to update person field configuration in Pipedrive. Use when you need to modify field properties like name, description, visibility settings, or requirement status. Only provided properties will be updated; omitted properties retain their existing values. Note: field\_code and field\_type cannot be changed.
>
> #### Input Parameters
>
> **field\_code** `string` *required*
>
> The unique code identifying the field (40-character hash for custom fields)
>
> **field\_name** `string`
>
> Field display name (1-255 characters). At least one request body parameter must be provided
>
> **description** `string`
>
> Field description text
>
> **ui\_visibility** `object`
>
> Controls field appearance in Pipedrive interface
>
> **required\_fields** `object`
>
> Marks field as mandatory
>
> **important\_fields** `object`
>
> Configuration for highlighting field at specific deal stages
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update product field
>
> **Slug:** `PIPEDRIVE_PRODUCTFIELDS_PATCH_PRODUCTFIELDS`
>
> Tool to update a product custom field. Use when you need to modify field name, UI visibility, or description. The field\_code and field\_type cannot be changed. At least one field must be provided in the request.
>
> #### Input Parameters
>
> **field\_code** `string` *required*
>
> The unique code identifying the field to update (40-character hash)
>
> **field\_name** `string`
>
> Field name (1-255 characters). At least one of field\_name, ui\_visibility, or description must be provided.
>
> **description** `string`
>
> Field description. Can be null to remove the description.
>
> **ui\_visibility** `object`
>
> UI visibility settings for the product field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Refreshing the tokens
>
> **Slug:** `PIPEDRIVE_REFRESH_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.
>
> #### Input Parameters
>
> **client\_id** `string`
>
> The client ID provided to you by the Pipedrive Marketplace when you register your app
>
> **grant\_type** `string ("authorization_code" | "refresh_token")`
>
> Since you are to refresh your access\_token, you must use the value "refresh\_token"
>
> **client\_secret** `string`
>
> The client secret provided to you by the Pipedrive Marketplace when you register your app
>
> **refresh\_token** `string`
>
> The refresh token that you received after you exchanged the authorization code
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Requesting authorization
>
> **Slug:** `PIPEDRIVE_REQUEST_AUTHORIZATION`
>
> Requests the Pipedrive OAuth authorization page for an app and returns the response status, any redirect location, and a short body snippet. A user must complete authorization separately.
>
> #### Input Parameters
>
> **state** `string`
>
> You may pass any random string as the state parameter and the same string will be returned to your app after a user authorizes access. It may be used to store the user"s session ID from your app or distinguish different responses. Using state may increase security; see RFC-6749. The state parameter is not automatically available in Marketplace Manager. To enable it for your app, please write to us at [marketplace.devs@pipedrive.com](mailto:marketplace.devs@pipedrive.com).
>
> **client\_id** `string` *required*
>
> The client ID provided to you by the Pipedrive Marketplace when you register your app
>
> **redirect\_uri** `string` *required*
>
> The callback URL you provided when you registered your app. Authorization code will be sent to that URL (if it matches with the value you entered in the registration form) if a user approves the app install. Or, if a customer declines, the corresponding error will also be sent to this URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search deals
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **term** `string` *required*
>
> The search term to look for. Minimum 2 characters required (or 1 character if exact\_match is set to true). Please note that the search term has to be URL encoded.
>
> **limit** `integer`
>
> Items shown per page. Maximum value is 100.
>
> **start** `integer`
>
> Pagination start. Note that the pagination is based on main results and does not include related items when using `search_for_related_items` parameter.
>
> **fields** `string ("custom_fields" | "notes" | "title")`
>
> A comma-separated string array. The fields to perform the search from. Defaults to all of them. Only the following custom field types are searchable: `address`, `varchar`, `text`, `varchar_auto`, `double`, `monetary` and `phone`. Read more about searching by custom fields \<a href="[https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields](https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields)" target="\_blank" rel="noopener noreferrer">here\</a>.
>
> **status** `string ("open" | "won" | "lost")`
>
> Will filter deals by the provided specific status. open = Open, won = Won, lost = Lost. The upper limit of found deals associated with the status is 2000.
>
> **person\_id** `integer`
>
> Will filter deals by the provided person ID. The upper limit of found deals associated with the person is 2000.
>
> **exact\_match** `boolean`
>
> When enabled, only full exact matches against the given term are returned. It is \<b>not\</b> case sensitive.
>
> **include\_fields** `string ("deal.cc_email")`
>
> Supports including optional fields in the results which are not provided by default
>
> **organization\_id** `integer`
>
> Will filter deals by the provided organization ID. The upper limit of found deals associated with the organization is 2000.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Item By Field
>
> **Slug:** `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, persons, organizations or products).
>
> #### Input Parameters
>
> **term** `string` *required*
>
> The search term to look for. Minimum 2 characters (or 1 if using `exact_match`). Please note that the search term has to be URL encoded.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start
>
> **field\_key** `string` *required*
>
> The key of the field to search from. The field key can be obtained by fetching the list of the fields using any of the fields" API GET methods (dealFields, personFields, etc.). Only the following custom field types are searchable: `address`, `varchar`, `text`, `varchar_auto`, `double`, `monetary` and `phone`. Read more about searching by custom fields \<a href="[https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields](https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields)" target="\_blank" rel="noopener noreferrer">here\</a>.
>
> **field\_type** `string ("dealField" | "leadField" | "personField" | "organizationField" | "productField" | "projectField")` *required*
>
> The type of the field to perform the search from
>
> **exact\_match** `boolean`
>
> When enabled, only full exact matches against the given term are returned. The search \<b>is\</b> case sensitive.
>
> **return\_item\_ids** `boolean`
>
> Whether to return the IDs of the matching items or not. When not set or set to `0` or `false`, only distinct values of the searched field are returned. When set to `1` or `true`, the ID of each found item is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search leads
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **term** `string` *required*
>
> The search term to look for. Minimum 2 characters (or 1 if using `exact_match`). Please note that the search term has to be URL encoded.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start. Note that the pagination is based on main results and does not include related items when using `search_for_related_items` parameter.
>
> **fields** `string ("custom_fields" | "notes" | "title")`
>
> A comma-separated string array. The fields to perform the search from. Defaults to all of them.
>
> **person\_id** `integer`
>
> Will filter leads by the provided person ID. The upper limit of found leads associated with the person is 2000.
>
> **exact\_match** `boolean`
>
> When enabled, only full exact matches against the given term are returned. It is \<b>not\</b> case sensitive.
>
> **include\_fields** `string ("lead.was_seen")`
>
> Supports including optional fields in the results which are not provided by default
>
> **organization\_id** `integer`
>
> Will filter leads by the provided organization ID. The upper limit of found leads associated with the organization is 2000.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Perform a search from multiple item types
>
> **Slug:** `PIPEDRIVE_SEARCH_MULTIPLE_ITEM_TYPES`
>
> Searches across item types and fields, with optional selection of one item type and one field.
>
> #### Input Parameters
>
> **term** `string` *required*
>
> The search term to look for. Minimum 2 characters (or 1 if using `exact_match`). Please note that the search term has to be URL encoded.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start. Note that the pagination is based on main results and does not include related items when using `search_for_related_items` parameter.
>
> **fields** `string ("address" | "code" | "custom_fields" | "email" | "name" | "notes" | "organization_name" | "person_name" | "phone" | "title" | "description")`
>
> A comma-separated string array. The fields to perform the search from. Defaults to all. Relevant for each item type are:\
> &#x20;\<table> \<tr>\<th>\<b>Item type\</b>\</th>\<th>\<b>Field\</b>\</th>\</tr> \<tr>\<td>Deal\</td>\<td>`custom_fields`, `notes`, `title`\</td>\</tr> \<tr>\<td>Person\</td>\<td>`custom_fields`, `email`, `name`, `notes`, `phone`\</td>\</tr> \<tr>\<td>Organization\</td>\<td>`address`, `custom_fields`, `name`, `notes`\</td>\</tr> \<tr>\<td>Product\</td>\<td>`code`, `custom_fields`, `name`\</td>\</tr> \<tr>\<td>Lead\</td>\<td>`custom_fields`, `notes`, `email`, `organization_name`, `person_name`, `phone`, `title`\</td>\</tr> \<tr>\<td>File\</td>\<td>`name`\</td>\</tr> \<tr>\<td>Mail attachment\</td>\<td>`name`\</td>\</tr> \<tr>\<td>Project\</td>\<td> `custom_fields`, `notes`, `title`, `description` \</td>\</tr> \</table> \
> &#x20;Only the following custom field types are searchable: `address`, `varchar`, `text`, `varchar_auto`, `double`, `monetary` and `phone`. Read more about searching by custom fields \<a href="[https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields](https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields)" target="\_blank" rel="noopener noreferrer">here\</a>.\
> &#x20;When searching for leads, the email, organization\_name, person\_name, and phone fields will return results only for leads not linked to contacts. For searching leads by person or organization values, please use `search_for_related_items`.
>
> **item\_types** `string ("deal" | "person" | "organization" | "product" | "lead" | "file" | "mail_attachment" | "project")`
>
> A comma-separated string array. The type of items to perform the search from. Defaults to all.
>
> **exact\_match** `boolean`
>
> When enabled, only full exact matches against the given term are returned. It is \<b>not\</b> case sensitive.
>
> **include\_fields** `string ("deal.cc_email" | "person.picture" | "product.price")`
>
> A comma-separated string array. Supports including optional fields in the results which are not provided by default.
>
> **search\_for\_related\_items** `boolean`
>
> When enabled, the response will include up to 100 newest related leads and 100 newest related deals for each found person and organization and up to 100 newest related persons for each found organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search organizations
>
> **Slug:** `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"\&gt;/v1/itemSearch\&lt;/a](https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItem"\&gt;/v1/itemSearch\&lt;/a)> with a narrower OAuth scope.
>
> #### Input Parameters
>
> **term** `string` *required*
>
> The search term to look for. Minimum 2 characters (or 1 if using `exact_match`). Please note that the search term has to be URL encoded.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start. Note that the pagination is based on main results and does not include related items when using `search_for_related_items` parameter.
>
> **fields** `string ("address" | "custom_fields" | "notes" | "name")`
>
> A comma-separated string array. The fields to perform the search from. Defaults to all of them. Only the following custom field types are searchable: `address`, `varchar`, `text`, `varchar_auto`, `double`, `monetary` and `phone`. Read more about searching by custom fields \<a href="[https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields](https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields)" target="\_blank" rel="noopener noreferrer">here\</a>.
>
> **exact\_match** `boolean`
>
> When enabled, only full exact matches against the given term are returned. It is \<b>not\</b> case sensitive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search persons
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **term** `string` *required*
>
> The search term to look for. Minimum 2 characters (or 1 if using `exact_match`). Wildcards like '\*' or '@' are NOT supported. To list all persons in an organization, use the GET\_ALL\_PERSONS or LIST\_PERSONS\_OF\_AN\_ORGANIZATION action instead.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start. Note that the pagination is based on main results and does not include related items when using `search_for_related_items` parameter.
>
> **fields** `string ("custom_fields" | "email" | "notes" | "phone" | "name")`
>
> The field to perform the search from. Defaults to all searchable fields. Only the following custom field types are searchable: address, varchar, text, varchar\_auto, double, monetary and phone.
>
> **exact\_match** `boolean`
>
> When enabled, only full exact matches against the given term are returned. It is \<b>not\</b> case sensitive.
>
> **include\_fields** `string ("person.picture")`
>
> Supports including optional fields in the results which are not provided by default
>
> **organization\_id** `integer`
>
> Will filter persons by the provided organization ID. The upper limit of found persons associated with the organization is 2000.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search products
>
> **Slug:** `PIPEDRIVE_SEARCH_PRODUCTS`
>
> Searches Pipedrive products by name, code or custom fields, with optional case-insensitive exact matching and pagination. DEPRECATED: The API v1 product search endpoint is out of support and its availability is not guaranteed; use GET /api/v2/products/search instead.
>
> #### Input Parameters
>
> **term** `string` *required*
>
> The search term to look for. Minimum 2 characters (or 1 if using `exact_match`). Please note that the search term has to be URL encoded.
>
> **limit** `integer`
>
> Items shown per page
>
> **start** `integer`
>
> Pagination start. Note that the pagination is based on main results and does not include related items when using `search_for_related_items` parameter.
>
> **fields** `string ("code" | "custom_fields" | "name")`
>
> A comma-separated string array. The fields to perform the search from. Defaults to all of them. Only the following custom field types are searchable: `address`, `varchar`, `text`, `varchar_auto`, `double`, `monetary` and `phone`. Read more about searching by custom fields \<a href="[https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields](https://support.pipedrive.com/en/article/search-finding-what-you-need#searching-by-custom-fields)" target="\_blank" rel="noopener noreferrer">here\</a>.
>
> **exact\_match** `boolean`
>
> When enabled, only full exact matches against the given term are returned. It is \<b>not\</b> case sensitive.
>
> **include\_fields** `string ("product.price")`
>
> Supports including optional fields in the results which are not provided by default
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update stage
>
> **Slug:** `PIPEDRIVE_TAGES_UPDATE_STAGE`
>
> Tool to update an existing stage in Pipedrive. Use when you need to modify stage properties such as name, deal probability, or rotten deal settings.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the stage to update
>
> **name** `string`
>
> The name of the stage
>
> **pipeline\_id** `integer`
>
> The ID of the pipeline to add stage to
>
> **days\_to\_rotten** `integer`
>
> Number of days before deals become rotten; applies only when is\_deal\_rot\_enabled is enabled
>
> **deal\_probability** `integer`
>
> Success probability percentage for deals; utilized when deal weighted values are active. Must be between 0 and 100.
>
> **is\_deal\_rot\_enabled** `boolean`
>
> Whether deals in this stage can become rotten
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unlinkuserfromvideocallintegration
>
> **Slug:** `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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier linking a user to the installed integration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a comment related to a note
>
> **Slug:** `PIPEDRIVE_UPDATE_A_COMMENT_RELATED_TO_A_NOTE`
>
> Updates a comment related to a note.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note
>
> **content** `string` *required*
>
> The content of the comment in HTML format. Subject to sanitization on the back-end.
>
> **commentId** `string` *required*
>
> The ID of the comment
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an activity
>
> **Slug:** `PIPEDRIVE_UPDATE_ACTIVITY`
>
> Tool to update an existing activity in Pipedrive including scheduling, assignments, descriptions, and participants. Use when you need to modify any properties of an activity such as subject, due date/time, status, or associated entities.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique identifier of the activity to update
>
> **busy** `boolean`
>
> Calendar availability flag (true=busy, false=available)
>
> **done** `boolean`
>
> Completion status indicator (true=completed, false=not completed)
>
> **note** `string`
>
> Internal activity comments/notes
>
> **type** `string`
>
> The activity category/type (e.g., 'call', 'meeting', 'task')
>
> **org\_id** `integer`
>
> Associated organization identifier
>
> **deal\_id** `integer`
>
> Associated deal identifier
>
> **lead\_id** `string`
>
> Associated lead identifier (UUID format)
>
> **subject** `string`
>
> The activity's title/subject
>
> **due\_date** `string`
>
> Activity date in YYYY-MM-DD format
>
> **due\_time** `string`
>
> Activity time in HH:MM format
>
> **duration** `string`
>
> Activity length in HH:MM format
>
> **location** `string`
>
> Geographic information with address fields or simple string address
>
> **owner\_id** `integer`
>
> User ID assigned to the activity
>
> **priority** `integer`
>
> Importance level of the activity
>
> **attendees** `array`
>
> External and internal meeting participants with email, name, and status
>
> **person\_id** `integer`
>
> Primary participant identifier
>
> **project\_id** `integer`
>
> Associated project identifier
>
> **participants** `array`
>
> Multiple person associations for the activity
>
> **public\_description** `string`
>
> Calendar-synced event details visible in external calendars
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update activity in project plan
>
> **Slug:** `PIPEDRIVE_UPDATE_ACTIVITY_IN_PROJECT_PLAN`
>
> Updates an activity phase or group in a project.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> **group\_id** `integer`
>
> The ID of a group on a project board
>
> **phase\_id** `integer`
>
> The ID of a phase on a project board
>
> **activityId** `integer` *required*
>
> The ID of the activity
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update activity type
>
> **Slug:** `PIPEDRIVE_UPDATE_ACTIVITY_TYPE`
>
> Tool to update an activity type in Pipedrive. Use when you need to modify the name, icon, color, or order of an existing activity type.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The identifier of the activity type to update
>
> **name** `string`
>
> The designation of the activity type
>
> **color** `string`
>
> Six-character hexadecimal color code (e.g., FFFFFF for white, 000000 for black)
>
> **icon\_key** `string ("task" | "email" | "meeting" | "deadline" | "call" | "lunch" | "calendar" | "downarrow" | "document" | "smartphone" | "camera" | "scissors" | "cogs" | "bubble" | "uparrow" | "checkbox" | "signpost" | "shuffle" | "addressbook" | "linegraph" | "picture" | "car" | "world" | "search" | "clip" | "sound" | "brush" | "key" | "padlock" | "pricetag" | "suitcase" | "finish" | "plane" | "loop" | "wifi" | "truck" | "cart" | "bulb" | "bell" | "presentation")`
>
> Permitted icon values for activity types.
>
> **order\_nr** `integer`
>
> An order number for this activity type. Order numbers should be used to order the types in the activity type selections.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a deal
>
> **Slug:** `PIPEDRIVE_UPDATE_A_DEAL`
>
> Updates supported properties of a deal, such as its title, owner, stage, value, or status. Archived deals cannot be edited with this action. DEPRECATED: This API v1 endpoint is out of support and its availability and behavior are not guaranteed; use PATCH /api/v2/deals/\{id} instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **title** `string`
>
> The deal title
>
> **value** `number`
>
> Monetary value of the deal
>
> **org\_id** `integer`
>
> ID of the organization
>
> **status** `string`
>
> Status of the deal (open, won, lost). Defaults to open
>
> **user\_id** `integer`
>
> ID of the user who will be marked as owner of this deal
>
> **currency** `string`
>
> Currency for the deal value (3-letter ISO code)
>
> **stage\_id** `integer`
>
> Stage ID for the deal
>
> **person\_id** `integer`
>
> ID of the person this deal is linked to
>
> **visible\_to** `integer`
>
> Visibility of the deal (owner, entire company etc)
>
> **lost\_reason** `string`
>
> Reason for losing the deal (only with status=lost)
>
> **pipeline\_id** `integer`
>
> Pipeline ID for the deal
>
> **probability** `number`
>
> Success probability percentage (0-100)
>
> **expected\_close\_date** `string`
>
> Expected close date in format YYYY-MM-DD
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a deal field
>
> **Slug:** `PIPEDRIVE_UPDATE_A_DEAL_FIELD`
>
> Updates a deal field definition's name, options, or visibility in the add-new dialog.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the field
>
> **name** `string`
>
> The name of the field
>
> **options** `array`
>
> When `field_type` is either set or enum, possible options must be supplied as a JSON-encoded sequential array of objects. All active items must be supplied and already existing items must have their ID supplied. New items only require a label. Example: `[{"id":123,"label":"Existing Item"},{"label":"New Item"}]`
>
> **add\_visible\_flag** `boolean`
>
> Whether the field is available in "add new" modal or not (both in web and mobile app)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a filter
>
> **Slug:** `PIPEDRIVE_UPDATE_A_FILTER`
>
> Updates an existing filter in Pipedrive. Use when you need to modify filter name or conditions. Maximum of 16 conditions per filter allowed.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the filter to update
>
> **name** `string`
>
> The name assigned to the filter
>
> **conditions** `object`
>
> Filter conditions as JSON object. Maximum of 16 conditions per filter. Date values must use YYYY-MM-DD format. Structure: \{"glue":"and","conditions":\[\{"object":"","field\_id":"","operator":"","value":""}]}
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a lead
>
> **Slug:** `PIPEDRIVE_UPDATE_A_LEAD`
>
> Updates supported properties of a lead. Archived leads can only be unarchived; other edits require the lead to be unarchived first.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the lead
>
> **title** `string`
>
> The name of the lead
>
> **owner\_id** `integer`
>
> The ID of the user which will be the owner of the created lead. If not provided, the user making the request will be used.
>
> **was\_seen** `boolean`
>
> A flag indicating whether the lead was seen by someone in the Pipedrive UI
>
> **label\_ids** `array`
>
> The IDs of the lead labels which will be associated with the lead
>
> **person\_id** `integer`
>
> The ID of a person which this lead will be linked to. If the person does not exist yet, it needs to be created first. A lead always has to be linked to a person or organization or both.
>
> **is\_archived** `boolean`
>
> A flag indicating whether the lead is archived or not
>
> **value\_\_amount** `integer`
>
> Amount
>
> **organization\_id** `integer`
>
> The ID of an organization which this lead will be linked to. If the organization does not exist yet, it needs to be created first. A lead always has to be linked to a person or organization or both.
>
> **value\_\_currency** `string`
>
> Currency
>
> **expected\_close\_date** `string`
>
> The date of when the deal which will be created from the lead is expected to be closed. In ISO 8601 format: YYYY-MM-DD.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a lead label
>
> **Slug:** `PIPEDRIVE_UPDATE_A_LEAD_LABEL`
>
> Updates one or more properties of a lead label. Only properties included in the request will be updated.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the lead label
>
> **name** `string`
>
> The name of the lead label
>
> **color** `string ("green" | "blue" | "red" | "yellow" | "purple" | "gray" | "brown" | "dark-gray" | "orange" | "pink")`
>
> The color of the label. Only a subset of colors can be used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an activity
>
> **Slug:** `PIPEDRIVE_UPDATE_AN_ACTIVITY`
>
> Updates an activity by ID and returns the updated activity.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the activity
>
> **done** `integer`
>
> Whether the activity is done (0 = not done, 1 = done)
>
> **note** `string`
>
> The note of the activity (HTML supported)
>
> **type** `string`
>
> The type of the activity (e.g., call, meeting), correlates with ActivityTypes key\_string
>
> **org\_id** `integer`
>
> ID of the organization linked to the activity
>
> **deal\_id** `integer`
>
> ID of the deal linked to the activity
>
> **subject** `string`
>
> The subject of the activity
>
> **user\_id** `integer`
>
> ID of the user who will own the activity
>
> **due\_date** `string`
>
> The due date of the activity (YYYY-MM-DD)
>
> **due\_time** `string`
>
> The due time of the activity (HH:MM)
>
> **duration** `string`
>
> The duration of the activity (e.g., 00:30)
>
> **location** `string`
>
> Location of the activity
>
> **person\_id** `integer`
>
> ID of the person linked to the activity
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an activity type
>
> **Slug:** `PIPEDRIVE_UPDATE_AN_ACTIVITY_TYPE`
>
> Updates an activity type.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the activity type
>
> **name** `string`
>
> The name of the activity type
>
> **color** `string`
>
> A designated color for the activity type in 6-character HEX format (e.g. `FFFFFF` for white, `000000` for black)
>
> **icon\_key** `string ("task" | "email" | "meeting" | "deadline" | "call" | "lunch" | "calendar" | "downarrow" | "document" | "smartphone" | "camera" | "scissors" | "cogs" | "bubble" | "uparrow" | "checkbox" | "signpost" | "shuffle" | "addressbook" | "linegraph" | "picture" | "car" | "world" | "search" | "clip" | "sound" | "brush" | "key" | "padlock" | "pricetag" | "suitcase" | "finish" | "plane" | "loop" | "wifi" | "truck" | "cart" | "bulb" | "bell" | "presentation")`
>
> Icon graphic to use for representing this activity type
>
> **order\_nr** `integer`
>
> An order number for this activity type. Order numbers should be used to order the types in the activity type selections.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an organization
>
> **Slug:** `PIPEDRIVE_UPDATE_AN_ORGANIZATION`
>
> Updates the properties of an organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization
>
> **name** `string`
>
> Organization name
>
> **address** `string`
>
> Formatted address string
>
> **website** `string`
>
> Organization website URL
>
> **industry** `integer`
>
> The numeric ID of the industry option. This is an enum field with predefined options specific to your Pipedrive account. Use PIPEDRIVE\_GET\_ALL\_ORGANIZATION\_FIELDS to retrieve the 'industry' field and its available options (each option has an 'id' and 'label'). Pass the option 'id' here, not the label text.
>
> **linkedin** `string`
>
> LinkedIn URL
>
> **owner\_id** `integer`
>
> Owner user ID
>
> **label\_ids** `array`
>
> IDs of labels to assign
>
> **visible\_to** `integer`
>
> Visibility (e.g., 1=owner only, 3=entire company)
>
> **annual\_revenue** `integer`
>
> The numeric ID of the annual revenue option. This is an enum field with predefined options specific to your Pipedrive account. Use PIPEDRIVE\_GET\_ALL\_ORGANIZATION\_FIELDS to retrieve the 'annual\_revenue' field and its available options (each option has an 'id' and 'label'). Pass the option 'id' here, not the label text.
>
> **employee\_count** `integer`
>
> Employee count
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an organization field
>
> **Slug:** `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](https://pipedrive.readme.io/docs/updating-custom-field-value) " target="\_blank" rel="noopener noreferrer">updating custom fields' values\</a>.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the field
>
> **name** `string`
>
> The name of the field
>
> **options** `array`
>
> When `field_type` is either set or enum, possible options must be supplied as a JSON-encoded sequential array of objects. All active items must be supplied and already existing items must have their ID supplied. New items only require a label. Example: `[{"id":123,"label":"Existing Item"},{"label":"New Item"}]`
>
> **add\_visible\_flag** `boolean`
>
> Whether the field is available in "add new" modal or not (both in web and mobile app)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an organization relationship
>
> **Slug:** `PIPEDRIVE_UPDATE_AN_ORGANIZATION_RELATIONSHIP`
>
> Updates and returns an organization relationship.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization relationship
>
> **type** `string ("parent" | "related")`
>
> The type of organization relationship
>
> **org\_id** `integer`
>
> The ID of the base organization for the returned calculated values
>
> **rel\_owner\_org\_id** `integer`
>
> The owner of this relationship. If type is `parent`, then the owner is the parent and the linked organization is the daughter.
>
> **rel\_linked\_org\_id** `integer`
>
> The linked organization in this relationship. If type is `parent`, then the linked organization is the daughter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a note
>
> **Slug:** `PIPEDRIVE_UPDATE_A_NOTE`
>
> Updates a note.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note
>
> **org\_id** `integer`
>
> The ID of the organization the note will be attached to.
>
> **content** `string`
>
> The content of the note in HTML format; subject to sanitization.
>
> **deal\_id** `integer`
>
> The ID of the deal the note will be attached to.
>
> **lead\_id** `string`
>
> The ID (UUID) of the lead the note will be attached to.
>
> **user\_id** `integer`
>
> The ID of the user to mark as the note’s author (admin only).
>
> **add\_time** `string`
>
> Optional creation date & time of the note in UTC. Format: YYYY-MM-DD HH:MM:SS
>
> **person\_id** `integer`
>
> The ID of the person the note will be attached to.
>
> **project\_id** `integer`
>
> The ID of the project the note will be attached to.
>
> **pinned\_to\_deal\_flag** `integer`
>
> If set, updates note-to-deal pinning state (requires deal\_id). 0 or 1.
>
> **pinned\_to\_lead\_flag** `integer`
>
> If set, updates note-to-lead pinning state (requires lead\_id). 0 or 1.
>
> **pinned\_to\_person\_flag** `integer`
>
> If set, updates note-to-person pinning state (requires person\_id). 0 or 1.
>
> **pinned\_to\_project\_flag** `integer`
>
> If set, updates note-to-project pinning state (requires project\_id). 0 or 1.
>
> **pinned\_to\_organization\_flag** `integer`
>
> If set, updates note-to-organization pinning state (requires org\_id). 0 or 1.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a person
>
> **Slug:** `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`.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person
>
> **name** `string`
>
> The name of the person
>
> **email** `array`
>
> List of email objects: \{ value: string, label?: string, primary?: bool }
>
> **phone** `array`
>
> List of phone objects: \{ value: string, label?: string, primary?: bool }
>
> **org\_id** `integer`
>
> ID of the linked organization
>
> **add\_time** `string`
>
> Creation time (RFC 3339)
>
> **owner\_id** `integer`
>
> ID of the user who will be marked as the owner of this person
>
> **label\_ids** `array`
>
> IDs of labels to assign to the person
>
> **visible\_to** `integer`
>
> Visibility of the person (e.g., 1=owner only, 3=entire company)
>
> **update\_time** `string`
>
> Last update time (RFC 3339)
>
> **marketing\_status** `string`
>
> Marketing status (no\_consent, unsubscribed, subscribed, archived). Field is available only when Campaigns is enabled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a person field
>
> **Slug:** `PIPEDRIVE_UPDATE_A_PERSON_FIELD`
>
> Updates a person field's name, options, or availability in the add-new modal. Availability defaults to enabled if omitted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the field
>
> **name** `string`
>
> The name of the field
>
> **options** `array`
>
> When `field_type` is either set or enum, possible options must be supplied as a JSON-encoded sequential array of objects. All active items must be supplied and already existing items must have their ID supplied. New items only require a label. Example: `[{"id":123,"label":"Existing Item"},{"label":"New Item"}]`
>
> **add\_visible\_flag** `boolean`
>
> Whether the field is available in "add new" modal or not (both in web and mobile app)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a pipeline
>
> **Slug:** `PIPEDRIVE_UPDATE_A_PIPELINE`
>
> Updates the properties of a pipeline (v2).
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the pipeline
>
> **name** `string`
>
> The name of the pipeline
>
> **is\_deal\_probability\_enabled** `boolean`
>
> Whether deal probability is enabled for this pipeline
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a product
>
> **Slug:** `PIPEDRIVE_UPDATE_A_PRODUCT`
>
> Updates product data.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **tax** `number`
>
> Tax percentage
>
> **code** `string`
>
> Product code
>
> **name** `string`
>
> Product name
>
> **unit** `string`
>
> Sales unit of the product
>
> **prices** `array`
>
> Array of prices per currency
>
> **category** `integer`
>
> Product category
>
> **owner\_id** `integer`
>
> Owner user ID; if omitted, authorized user ID is used
>
> **visible\_to** `integer`
>
> Product visibility setting
>
> **description** `string`
>
> Product description
>
> **is\_linkable** `boolean`
>
> Whether the product can be added to a deal
>
> **billing\_frequency** `string`
>
> Billing frequency (one-time, annually, semi-annually, quarterly, monthly, weekly)
>
> **billing\_frequency\_cycles** `integer`
>
> Number of billing repeats (rules depend on billing\_frequency)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a product field
>
> **Slug:** `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](https://pipedrive.readme.io/docs/updating-custom-field-value) " target="\_blank" rel="noopener noreferrer">updating custom fields' values\</a>.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product field
>
> **name** `string`
>
> The name of the field
>
> **options** `array`
>
> When `field_type` is either set or enum, possible options on update must be supplied as an array of objects each containing id and label, for example: \[\{"id":1, "label":"red"},\{"id":2, "label":"blue"},\{"id":3, "label":"lilac"}]
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update comment for note
>
> **Slug:** `PIPEDRIVE_UPDATE_COMMENT_FOR_NOTE`
>
> Tool to update a comment on a note in Pipedrive. Use when you need to modify the content of an existing comment attached to a note.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note
>
> **content** `string` *required*
>
> The updated content of the comment in HTML format. Subject to sanitization on the back-end.
>
> **commentId** `string` *required*
>
> The ID of the comment in UUID format
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a deal
>
> **Slug:** `PIPEDRIVE_UPDATE_DEAL`
>
> Updates an existing Pipedrive deal's properties, such as title, value, status, stage, or associated contacts and organizations. Archived deals can only be unarchived. DEPRECATED: The API v1 endpoint is out of support and availability is not guaranteed; use PATCH /api/v2/deals/\{id} instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal to update
>
> **title** `string`
>
> The title/name of the deal
>
> **value** `number`
>
> The monetary value of the deal
>
> **org\_id** `integer`
>
> The ID of the organization associated with the deal
>
> **status** `string ("open" | "won" | "lost")`
>
> The status of the deal. Must be one of: open, won, lost
>
> **currency** `string`
>
> Three-letter ISO currency code for the deal value
>
> **owner\_id** `integer`
>
> The ID of the user who owns the deal
>
> **stage\_id** `integer`
>
> The ID of the stage within the pipeline
>
> **won\_time** `string`
>
> Date and time when status changed to won
>
> **label\_ids** `array`
>
> Array of label IDs assigned to the deal
>
> **lost\_time** `string`
>
> Date and time when status changed to lost
>
> **person\_id** `integer`
>
> The ID of the person/contact associated with the deal
>
> **close\_time** `string`
>
> Date and time of closing the deal (for won/lost status)
>
> **visible\_to** `integer`
>
> Visibility setting for the deal
>
> **is\_archived** `boolean`
>
> Whether the deal is archived. Note: From July 15, 2025, archived deals cannot be edited except for this property.
>
> **lost\_reason** `string`
>
> Reason for losing the deal. Required when status is set to 'lost'
>
> **pipeline\_id** `integer`
>
> The ID of the pipeline for the deal. When changed, stage\_id auto-updates to first stage.
>
> **probability** `number`
>
> The success probability percentage (0-100)
>
> **archive\_time** `string`
>
> Date and time of archiving in UTC in YYYY-MM-DD HH:MM:SS format
>
> **expected\_close\_date** `string`
>
> Expected closing date in YYYY-MM-DD format
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update deal discount
>
> **Slug:** `PIPEDRIVE_UPDATE_DEAL_DISCOUNT`
>
> Tool to update a discount for a specific deal. Use when you need to modify the amount, description, or type of an existing discount added to a deal in Pipedrive.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **type** `string ("percentage" | "amount")`
>
> Determines whether the discount is applied as a percentage or a fixed amount.
>
> **amount** `number`
>
> The discount amount. Must be a positive number (excluding 0).
>
> **description** `string`
>
> The name of the discount.
>
> **discount\_id** `string` *required*
>
> The ID of the discount to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a deal field
>
> **Slug:** `PIPEDRIVE_UPDATE_DEAL_FIELD`
>
> Tool to update a deal field in Pipedrive. Use when you need to modify existing deal field properties such as name, visibility, or options. Note that field\_code and field\_type cannot be changed.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal field to update
>
> **name** `string`
>
> The name of the field
>
> **options** `array`
>
> When field\_type is either 'set' or 'enum', possible options must be supplied as a JSON-encoded sequential array of objects. All active items must be supplied and already existing items must have their ID supplied. New items only require a label. Example: \[\{"id":123,"label":"Existing Item"},\{"label":"New Item"}]
>
> **add\_visible\_flag** `boolean`
>
> Whether the field is available in "add new" modal or not (both in web and mobile app)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update deal field options
>
> **Slug:** `PIPEDRIVE_UPDATE_DEALFIELDS_OPTIONS`
>
> Tool to update existing options for a deal custom field atomically. Use when you need to modify labels of options in a deal field.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to update. At least one option is required. The entire request fails if any option ID does not exist (atomic operation).
>
> **field\_code** `string` *required*
>
> The unique 40-character code identifying the deal field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Deal Product
>
> **Slug:** `PIPEDRIVE_UPDATE_DEAL_PRODUCT`
>
> Updates a product attached to a deal with new values. Use when you need to modify price, quantity, discount, tax, or other properties of a deal product.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **tax** `number`
>
> The tax percentage or amount to apply
>
> **comments** `string`
>
> Comments or notes about this product attachment
>
> **discount** `number`
>
> The discount value. Use discount\_type to specify whether this is a percentage or fixed amount
>
> **quantity** `number`
>
> The quantity of the product in the deal
>
> **is\_enabled** `boolean`
>
> Whether the product is enabled in the deal. Disabled products are excluded from deal value calculations
>
> **item\_price** `number`
>
> The price at which this product will be updated in the deal
>
> **tax\_method** `string ("exclusive" | "inclusive" | "none")`
>
> Tax calculation method: 'exclusive' (tax added to price), 'inclusive' (tax included in price), or 'none'
>
> **discount\_type** `string ("percentage" | "amount")`
>
> The type of discount: 'percentage' or 'amount'
>
> **billing\_frequency** `string ("one-time" | "annually" | "semi-annually" | "quarterly" | "monthly" | "weekly")`
>
> Billing frequency for recurring products
>
> **billing\_start\_date** `string`
>
> Billing start date in YYYY-MM-DD format
>
> **product\_attachment\_id** `integer` *required*
>
> The ID of the deal-product attachment (returned when adding a product to a deal)
>
> **billing\_frequency\_cycles** `integer`
>
> Number of billing cycles for recurring products
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update the product attached to a deal
>
> **Slug:** `PIPEDRIVE_UPDATE_DEAL_PRODUCT_ATTACHMENT`
>
> Updates the details of the product that has been attached to a deal.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal
>
> **tax** `number`
>
> The tax percentage
>
> **comments** `string`
>
> A textual comment associated with this product-deal attachment
>
> **discount** `number`
>
> The value of the discount. The `discount_type` field can be used to specify whether the value is an amount or a percentage.
>
> **duration** `number`
>
> The duration of the product
>
> **quantity** `number`
>
> How many items of this product will be added to the deal
>
> **item\_price** `number`
>
> The price at which this product will be added to the deal
>
> **product\_id** `integer`
>
> The ID of the product to use
>
> **tax\_method** `string ("exclusive" | "inclusive" | "none")`
>
> The tax option to be applied to the products. When using `inclusive`, the tax percentage will already be included in the price. When using `exclusive`, the tax will not be included in the price. When using `none`, no tax will be added. Use the `tax` field for defining the tax percentage amount.
>
> **enabled\_flag** `boolean`
>
> Whether the product is enabled for a deal or not. This makes it possible to add products to a deal with a specific price and discount criteria, but keep them disabled, which refrains them from being included in the deal value calculation. When omitted, the product will be marked as enabled by default.
>
> **discount\_type** `string ("percentage" | "amount")`
>
> The type of the discount"s value.
>
> **product\_variation\_id** `integer`
>
> The ID of the product variation to use. When omitted, no variation will be used.
>
> **product\_attachment\_id** `integer` *required*
>
> The ID of the deal-product (the ID of the product attached to the deal)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update deal (v2 API)
>
> **Slug:** `PIPEDRIVE_UPDATE_DEAL_V2`
>
> Updates an existing deal using the Pipedrive v2 API, including custom fields, archive status, or deletion status. Archived deals cannot be edited except to unarchive them.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the deal to update
>
> **title** `string`
>
> The title of the deal
>
> **value** `number`
>
> The value of the deal
>
> **org\_id** `integer`
>
> The ID of the organization linked to the deal
>
> **status** `string`
>
> The status of the deal
>
> **currency** `string`
>
> The currency associated with the deal
>
> **owner\_id** `integer`
>
> The ID of the user who owns the deal
>
> **stage\_id** `integer`
>
> The ID of the deal stage
>
> **won\_time** `string`
>
> The date and time of changing the deal status as won. Can only be set if deal status is won.
>
> **label\_ids** `array`
>
> The IDs of labels assigned to the deal
>
> **lost\_time** `string`
>
> The date and time of changing the deal status as lost. Can only be set if deal status is lost.
>
> **person\_id** `integer`
>
> The ID of the person linked to the deal
>
> **close\_time** `string`
>
> The date and time of closing the deal. Can only be set if deal status is won or lost.
>
> **is\_deleted** `boolean`
>
> Whether the deal is deleted or not
>
> **visible\_to** `integer`
>
> The visibility of the deal
>
> **is\_archived** `boolean`
>
> Whether the deal is archived or not
>
> **lost\_reason** `string`
>
> The reason for losing the deal. Can only be set if deal status is lost.
>
> **pipeline\_id** `integer`
>
> The ID of the pipeline associated with the deal
>
> **probability** `integer`
>
> The success probability percentage of the deal (must be an integer)
>
> **archive\_time** `string`
>
> The optional date and time of archiving the deal in UTC. Format: YYYY-MM-DD HH:MM:SS. If omitted and is\_archived is true, it will be set to the current date and time.
>
> **custom\_fields** `object`
>
> An object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes
>
> **expected\_close\_date** `string`
>
> The expected close date of the deal in YYYY-MM-DD format
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update file details
>
> **Slug:** `PIPEDRIVE_UPDATE_FILE`
>
> Updates the visible name and description of a Pipedrive file.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the file to update
>
> **name** `string`
>
> The visible name of the file
>
> **description** `string`
>
> The description of the file
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update file details
>
> **Slug:** `PIPEDRIVE_UPDATE_FILE_DETAILS`
>
> Updates the visible name and description of a file.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the file
>
> **name** `string`
>
> The visible name of the file
>
> **description** `string`
>
> The description of the file
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update filter
>
> **Slug:** `PIPEDRIVE_UPDATE_FILTER`
>
> Updates the name of an existing filter.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the filter
>
> **name** `string`
>
> The name of the filter
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update existing goal
>
> **Slug:** `PIPEDRIVE_UPDATE_GOAL`
>
> Updates an existing goal. Note: For OAuth, Goals API is available under \{companydomain}/api/v1. The platform metadata base\_url may be \{companydomain}/v1, which yields 404 for PUT /goals/\{id}. We therefore construct the URL using the company domain and /api/v1 explicitly.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the goal
>
> **type** `object`
>
> The type of the goal and its parameters
>
> **title** `string`
>
> The title of the goal
>
> **assignee** `object`
>
> The assignee of the goal
>
> **duration** `object`
>
> Goal active duration
>
> **interval** `string ("weekly" | "monthly" | "quarterly" | "yearly")`
>
> The interval of the goal
>
> **expected\_outcome** `object`
>
> Expected outcome configuration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an installment subscription
>
> **Slug:** `PIPEDRIVE_UPDATE_INSTALLMENT_SUBSCRIPTION`
>
> Updates an installment subscription's payment schedule. The operation may instead create installments or create and attach products to a deal whose ID matches the supplied subscription ID. Changes are not atomic and may be partial.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the subscription
>
> **payments** `array` *required*
>
> Array of payments. It requires a minimum structure as follows: \[\{ amount:SUM, description:DESCRIPTION, due\_at:PAYMENT\_DATE }]. Replace SUM with a payment amount, DESCRIPTION with a explanation string, PAYMENT\_DATE with a date (format YYYY-MM-DD).
>
> **update\_deal\_value** `boolean`
>
> Indicates that the deal value must be set to installment subscription"s total value
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a lead
>
> **Slug:** `PIPEDRIVE_UPDATE_LEAD`
>
> Update an existing Pipedrive lead's properties, such as title, value, archive status, or linked contacts. Archived leads can only be unarchived.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the lead to update in UUID format
>
> **title** `string`
>
> The name/title of the lead
>
> **value** `object`
>
> Schema for the value object containing amount and currency
>
> **channel** `integer`
>
> Marketing channel identifier
>
> **owner\_id** `integer`
>
> The ID of the user who will own the lead
>
> **was\_seen** `boolean`
>
> Flag indicating if lead was seen in Pipedrive UI
>
> **label\_ids** `array`
>
> Array of lead label identifiers to assign to the lead
>
> **person\_id** `integer`
>
> ID of person to link to the lead. Lead requires person OR organization link. Set to null to unset.
>
> **channel\_id** `string`
>
> Optional ID to distinguish the marketing channel
>
> **visible\_to** `string`
>
> Visibility setting (values: 1, 3, 5, or 7 depending on plan)
>
> **is\_archived** `boolean`
>
> Archive status flag. Set to true to archive the lead, false to unarchive.
>
> **organization\_id** `integer`
>
> ID of organization to link to the lead. Lead requires person OR organization link. Set to null to unset.
>
> **expected\_close\_date** `string`
>
> Expected close date in ISO 8601 format (YYYY-MM-DD)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Lead Label
>
> **Slug:** `PIPEDRIVE_UPDATE_LEAD_LABEL`
>
> Tool to update a lead label in Pipedrive. Use when you need to modify the name or color of an existing lead label. Only properties included in the request will be updated.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the lead label to update (UUID format)
>
> **name** `string`
>
> The name of the lead label
>
> **color** `string ("blue" | "brown" | "dark-gray" | "gray" | "green" | "orange" | "pink" | "purple" | "red" | "yellow")`
>
> The color of the label. Only a subset of colors can be used: blue, brown, dark-gray, gray, green, orange, pink, purple, red, yellow
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update mail thread details
>
> **Slug:** `PIPEDRIVE_UPDATE_MAIL_THREAD`
>
> Updates the properties of a mail thread.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the mail thread
>
> **deal\_id** `integer`
>
> The ID of the deal this thread is associated with
>
> **lead\_id** `string`
>
> The ID of the lead this thread is associated with
>
> **read\_flag** `integer`
>
> Whether this thread is marked as read (0 or 1)
>
> **shared\_flag** `integer`
>
> Whether this thread is shared with other users (0 or 1)
>
> **archived\_flag** `integer`
>
> Whether this thread is archived (0 or 1)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Note
>
> **Slug:** `PIPEDRIVE_UPDATE_NOTE`
>
> Tool to update an existing note in Pipedrive. Use when you need to modify the content or properties of a note attached to deals, persons, organizations, leads, or projects.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the note to update
>
> **org\_id** `integer`
>
> The ID of the organization to attach the note to.
>
> **content** `string`
>
> The content of the note in HTML format. Subject to sanitization on the back-end.
>
> **deal\_id** `integer`
>
> The ID of the deal to attach the note to.
>
> **lead\_id** `string`
>
> The ID of the lead to attach the note to (UUID format).
>
> **user\_id** `integer`
>
> The ID of the user to mark as the note's author. Only administrators can change this.
>
> **add\_time** `string`
>
> Creation date and time of the note in UTC. Format: YYYY-MM-DD HH:MM:SS
>
> **person\_id** `integer`
>
> The ID of the person to attach the note to.
>
> **project\_id** `integer`
>
> The ID of the project to attach the note to.
>
> **pinned\_to\_deal\_flag** `integer ("0" | "1")`
>
> If set, updates the note-to-deal pinning state. Requires deal\_id to be set. 0 to unpin, 1 to pin.
>
> **pinned\_to\_lead\_flag** `integer ("0" | "1")`
>
> If set, updates the note-to-lead pinning state. Requires lead\_id to be set. 0 to unpin, 1 to pin.
>
> **pinned\_to\_person\_flag** `integer ("0" | "1")`
>
> If set, updates the note-to-person pinning state. Requires person\_id to be set. 0 to unpin, 1 to pin.
>
> **pinned\_to\_project\_flag** `integer ("0" | "1")`
>
> If set, updates the note-to-project pinning state. Requires project\_id to be set. 0 to unpin, 1 to pin.
>
> **pinned\_to\_organization\_flag** `integer ("0" | "1")`
>
> If set, updates the note-to-organization pinning state. Requires org\_id to be set. 0 to unpin, 1 to pin.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Organization
>
> **Slug:** `PIPEDRIVE_UPDATE_ORGANIZATION`
>
> Tool to update an existing organization in Pipedrive. Use when you need to modify organization properties such as name, owner, visibility, labels, or address.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique identifier of the organization to update
>
> **name** `string`
>
> The name of the organization
>
> **address** `object`
>
> Address object with structured fields
>
> **owner\_id** `integer`
>
> The ID of the user who owns the organization
>
> **label\_ids** `array`
>
> The IDs of labels assigned to the organization
>
> **visible\_to** `integer`
>
> The visibility of the organization. 1=owner only, 3=owner's visibility group, 7=entire company
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update organization field
>
> **Slug:** `PIPEDRIVE_UPDATE_ORGANIZATION_FIELD`
>
> Tool to update an organization field in Pipedrive. Use when you need to modify the name, options, or visibility of an existing organization field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization field to update
>
> **name** `string`
>
> The name of the field
>
> **options** `array`
>
> When field\_type is either set or enum, possible options must be supplied as a JSON-encoded sequential array. Existing items require an ID and new items only require a label. Example: \[\{'id': 123, 'label': 'Existing Item'}, \{'label': 'New Item'}]
>
> **add\_visible\_flag** `boolean`
>
> Whether the field is available in 'add new' modal or not (both in web and mobile app)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update organization field options
>
> **Slug:** `PIPEDRIVE_UPDATE_ORGANIZATION_FIELD_OPTIONS`
>
> Tool to update existing options for an organization custom field atomically. Use when you need to modify option labels for an organization field. All specified option IDs must exist or the entire request fails.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to update. At least one option is required. Each option must have an id (existing option identifier) and label (new display text). The operation is atomic: all updates succeed or none are applied.
>
> **field\_code** `string` *required*
>
> The unique code identifying the organization field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update organization relationship
>
> **Slug:** `PIPEDRIVE_UPDATE_ORGANIZATION_RELATIONSHIP`
>
> Tool to update an organization relationship in Pipedrive. Use when you need to modify the type or organizations involved in an existing relationship between two organizations.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the organization relationship to update
>
> **type** `string ("parent" | "related")`
>
> Permitted relationship types for organization relationships.
>
> **org\_id** `integer`
>
> The ID of the base organization for the returned calculated values
>
> **rel\_owner\_org\_id** `integer`
>
> The owner of this relationship. If type is 'parent', then the owner is the parent and the linked organization is the daughter.
>
> **rel\_linked\_org\_id** `integer`
>
> The linked organization in this relationship. If type is 'parent', then the linked organization is the daughter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a person
>
> **Slug:** `PIPEDRIVE_UPDATE_PERSON`
>
> Updates an existing Pipedrive person's properties, such as name, contact information, owner or organization. Changing the owner requires appropriate permission. DEPRECATED: The API v1 endpoint is out of support and availability is not guaranteed; use PATCH /api/v2/persons/\{id} instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person to update
>
> **name** `string`
>
> The person's full name
>
> **email** `array`
>
> Email addresses as an array of objects with properties: value (required), primary (optional), label (optional)
>
> **label** `integer`
>
> Label ID for categorizing the person (deprecated in v2, use label\_ids)
>
> **phone** `array`
>
> Phone numbers as an array of objects with properties: value (required), primary (optional), label (optional)
>
> **org\_id** `integer`
>
> The ID of the organization this person belongs to
>
> **add\_time** `string`
>
> The creation date and time of the person in UTC. Format: YYYY-MM-DD HH:MM:SS
>
> **owner\_id** `integer`
>
> The ID of the user who will be the owner of the person. Requires proper permissions; without can\_modify\_owner\_for\_people permission, a 403 error will be thrown.
>
> **label\_ids** `array`
>
> Array of label IDs to assign to the person
>
> **visible\_to** `integer`
>
> Visibility of the person. Values: 1 (Owner & followers), 3 (Entire company), 5 (Owner only), 7 (Owner's visibility group)
>
> **update\_time** `string`
>
> The last update date and time of the person in UTC. Format: YYYY-MM-DD HH:MM:SS
>
> **marketing\_status** `string ("no_consent" | "unsubscribed" | "subscribed" | "archived")`
>
> Marketing status. Only available if company uses Campaigns product. Must be one of: no\_consent, unsubscribed, subscribed, archived
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update person field
>
> **Slug:** `PIPEDRIVE_UPDATE_PERSON_FIELD`
>
> Tool to update a person field in Pipedrive. Use when you need to modify the name, options, or visibility settings of an existing person field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person field to update
>
> **name** `string`
>
> The field's display name
>
> **options** `array`
>
> For enum/set field types, supply all active items. Each item should include 'id' (integer) for existing options to keep, or 'label' (string) for new options to add or to update existing option labels.
>
> **add\_visible\_flag** `boolean`
>
> Controls whether the field is visible in 'add new' modal for web and mobile apps. Default is true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update person field options
>
> **Slug:** `PIPEDRIVE_UPDATE_PERSONFIELDS_OPTIONS`
>
> Tool to update existing options for a person custom field atomically. Use when you need to modify labels of options in a person field.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to update. At least one option is required. The entire request fails if any option ID does not exist (atomic operation).
>
> **field\_code** `string` *required*
>
> The unique code identifying the person field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update person (v2)
>
> **Slug:** `PIPEDRIVE_UPDATE_PERSON_V2`
>
> Tool to update a person's properties in Pipedrive using the v2 API. Use when you need to modify existing person details such as name, contact information, owner, or organization.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the person to update
>
> **name** `string`
>
> The person's full name
>
> **emails** `array`
>
> Email addresses as objects with properties: value, primary, label
>
> **org\_id** `integer`
>
> The ID of the organization this person belongs to
>
> **phones** `array`
>
> Phone numbers as objects with properties: value, primary, label
>
> **add\_time** `string`
>
> The creation date and time of the person in UTC. Format: YYYY-MM-DD HH:MM:SS
>
> **owner\_id** `integer`
>
> The ID of the user who will be the owner of the person
>
> **label\_ids** `array`
>
> Array of label IDs to assign to the person
>
> **last\_name** `string`
>
> The person's last name
>
> **first\_name** `string`
>
> The person's first name
>
> **visible\_to** `integer`
>
> Visibility of the person. Values: 1 (Owner & followers), 3 (Entire company), 5 (Owner only), 7 (Owner's visibility group)
>
> **update\_time** `string`
>
> The last update date and time of the person in UTC. Format: YYYY-MM-DD HH:MM:SS
>
> **marketing\_status** `string`
>
> Marketing status. Values: 'no\_consent', 'unsubscribed', 'subscribed', 'archived'. Only available if company uses Campaigns product.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a pipeline
>
> **Slug:** `PIPEDRIVE_UPDATE_PIPELINE`
>
> Updates a Pipedrive pipeline's name, deal probability, order, or active status by ID; only supplied fields are updated. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use PATCH /api/v2/pipelines/\{id} instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the pipeline to update
>
> **name** `string`
>
> The name of the pipeline
>
> **active** `integer`
>
> Whether the pipeline is inactive/hidden (0) or active (1)
>
> **order\_nr** `integer`
>
> Defines the order of pipelines. The pipeline with order\_nr=0 is the default pipeline
>
> **deal\_probability** `integer`
>
> Whether deal probability is disabled (0) or enabled (1) for this pipeline
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update pipeline visibility for a role
>
> **Slug:** `PIPEDRIVE_UPDATE_PIPELINE_VISIBILITY_FOR_ROLE`
>
> Updates pipeline visibility settings for different roles. For details, see the Pipedrive Visibility groups article.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **visible\_pipeline\_ids** `object` *required*
>
> Object specifying pipelines to add (visible) and/or remove (hidden) for the role
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a product
>
> **Slug:** `PIPEDRIVE_UPDATE_PRODUCT`
>
> Tool to update a product in Pipedrive. Use when you need to modify product details like name, code, price, tax, or other attributes.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product to update
>
> **tax** `number`
>
> Tax percentage. Default is 0.
>
> **code** `string`
>
> Product code/identifier
>
> **name** `string`
>
> Product name. Cannot be blank if provided.
>
> **unit** `string`
>
> Unit of measurement for the product
>
> **prices** `array`
>
> Array of price objects. There can only be one price per product per currency.
>
> **category** `string`
>
> Product category
>
> **owner\_id** `integer`
>
> ID of the user who will be marked as the owner. When omitted, the authorized user ID will be used.
>
> **selectable** `boolean`
>
> Whether the product is selectable. Changed from integer to boolean as of April 3, 2023.
>
> **visible\_to** `string`
>
> Visibility setting for the product. If omitted, default visibility will be used.
>
> **active\_flag** `boolean`
>
> Whether the product is active. Changed from integer to boolean as of April 3, 2023.
>
> **description** `string`
>
> Product description
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update product field
>
> **Slug:** `PIPEDRIVE_UPDATE_PRODUCT_FIELD`
>
> Tool to update a product field definition in Pipedrive. Use when you need to modify the name or options of an existing product custom field.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product field to update
>
> **name** `string`
>
> The name of the product field
>
> **options** `array`
>
> When field\_type is either 'set' or 'enum', possible options must be supplied as an array of objects, each containing 'id' and 'label' properties. Example: \[\{"id": 1, "label": "red"}, \{"id": 2, "label": "blue"}]
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update product field options
>
> **Slug:** `PIPEDRIVE_UPDATE_PRODUCTFIELDS_OPTIONS`
>
> Tool to update existing options for a product custom field atomically. Use when you need to modify labels of options in a product field.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> Array of option objects to update. At least one option is required. The entire request fails if any option ID does not exist (atomic operation).
>
> **field\_code** `string` *required*
>
> The unique code identifying the product field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update product image
>
> **Slug:** `PIPEDRIVE_UPDATE_PRODUCT_IMAGE`
>
> Tool to update an image for a product in Pipedrive. Use when you need to add or replace a product image.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product to update the image for
>
> **data** `object` *required*
>
> Image file to upload. FileType object with 'name' (image filename e.g., 'product.png', 'image.jpg') and 'content' (base64-encoded image data). Supported formats: PNG, JPG, JPEG, GIF.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update product variation
>
> **Slug:** `PIPEDRIVE_UPDATE_PRODUCT_VARIATION`
>
> Tool to update a product variation in Pipedrive. Use when you need to modify variation details like name or prices across different currencies.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the product
>
> **name** `string`
>
> The name of the product variation. Maximum length is 255 characters.
>
> **prices** `array`
>
> Array of price objects for different currencies. When omitted, existing prices remain unchanged. Only one price per variation per currency is supported.
>
> **product\_variation\_id** `integer` *required*
>
> The ID of the product variation to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a project
>
> **Slug:** `PIPEDRIVE_UPDATE_PROJECT`
>
> Updates a project.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> **title** `string`
>
> The title of the project
>
> **labels** `array`
>
> Array of IDs of labels the project has
>
> **org\_id** `integer`
>
> The ID of the associated organization
>
> **status** `string`
>
> The status of the project
>
> **board\_id** `integer`
>
> The ID of the board this project is associated with
>
> **deal\_ids** `array`
>
> Array of IDs of associated deals
>
> **end\_date** `string`
>
> The end date (YYYY-MM-DD)
>
> **owner\_id** `integer`
>
> The ID of a project owner
>
> **phase\_id** `integer`
>
> The ID of the phase this project is associated with
>
> **person\_id** `integer`
>
> The ID of the associated person
>
> **start\_date** `string`
>
> The start date (YYYY-MM-DD)
>
> **description** `string`
>
> The description of the project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a recurring subscription
>
> **Slug:** `PIPEDRIVE_UPDATE_RECURRING_SUBSCRIPTION`
>
> Updates a recurring subscription. Note: Some company hosts may not expose Subscriptions endpoints. This action will attempt multiple hosts and gracefully fall back to updating the product attached to a deal (v1) when applicable. In the fallback path, the request `id` is treated as the `product_attachment_id` and we locate the corresponding deal by scanning deal products.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the subscription
>
> **payments** `array`
>
> Array of additional payments. It requires a minimum structure as follows: \[\{ amount:SUM, description:DESCRIPTION, due\_at:PAYMENT\_DATE }]. Replace SUM with a payment amount, DESCRIPTION with an explanation string, PAYMENT\_DATE with a date (format YYYY-MM-DD).
>
> **description** `string`
>
> The description of the recurring subscription
>
> **cycle\_amount** `integer`
>
> The amount of each payment
>
> **effective\_date** `string` *required*
>
> All payments after that date will be affected. Format: YYYY-MM-DD
>
> **update\_deal\_value** `boolean`
>
> Indicates that the deal value must be set to recurring subscription"s MRR value
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update role details
>
> **Slug:** `PIPEDRIVE_UPDATE_ROLE`
>
> Updates the parent role and/or the name of a specific role. Notes: - Roles endpoints require the `admin` scope. - With OAuth (Bearer) tokens, Pipedrive expects the company domain base URL with `/api/v1` path, e.g. https\://\{COMPANY}.pipedrive.com/api/v1/roles/\{id} - This action normalizes the base\_url provided by metadata to ensure `/api/v1` is used with the company domain when available. Falls back to the global API host otherwise.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **name** `string`
>
> The name of the role
>
> **parent\_role\_id** `integer`
>
> The ID of the parent role
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update role pipelines
>
> **Slug:** `PIPEDRIVE_UPDATE_ROLE_PIPELINES`
>
> Updates pipeline visibility for a role. Use when you need to control which sales pipelines are accessible to users within a particular role group.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the role
>
> **visible\_pipeline\_ids** `object` *required*
>
> Structure for managing pipeline visibility. Specify pipeline IDs to add (make visible) or remove (make hidden) for the role.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update stage details
>
> **Slug:** `PIPEDRIVE_UPDATE_STAGE`
>
> Updates a Pipedrive stage's name, pipeline association, ordering, deal probability, or rotten deal settings. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use PATCH /api/v2/stages/\{id} instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the stage to update
>
> **name** `string`
>
> The name of the stage. Cannot be null or empty when provided.
>
> **order\_nr** `integer`
>
> Numerical ordering position for the stage within its pipeline.
>
> **pipeline\_id** `integer`
>
> The pipeline ID the stage belongs to. Must match an existing pipeline.
>
> **rotten\_days** `integer`
>
> Number of days before deals become rotten. Only applies when rotten\_flag is enabled.
>
> **rotten\_flag** `boolean`
>
> Whether deals in this stage can become rotten (deteriorate).
>
> **deal\_probability** `integer`
>
> Success probability percentage for deals in this stage. Must be between 0 and 100.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update stage details
>
> **Slug:** `PIPEDRIVE_UPDATE_STAGE_DETAILS`
>
> Updates a Pipedrive stage's name, pipeline, ordering, deal probability, or rotten deal settings. API errors may be returned in the result rather than raised. DEPRECATED: The API v1 endpoint is out of support and its availability is not guaranteed; use PATCH /api/v2/stages/\{id} instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the stage
>
> **name** `string`
>
> The name of the stage
>
> **order\_nr** `integer`
>
> Order number of this stage within its pipeline
>
> **pipeline\_id** `integer`
>
> The ID of the pipeline to add the stage to
>
> **rotten\_days** `integer`
>
> Days until deals become rotten (applies when rotten\_flag is true)
>
> **rotten\_flag** `boolean`
>
> Whether deals in this stage can become rotten
>
> **deal\_probability** `integer`
>
> Success probability percentage (0–100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a task
>
> **Slug:** `PIPEDRIVE_UPDATE_TASK`
>
> Updates a task.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the task
>
> **done** `integer`
>
> 0 = Not done, 1 = Done
>
> **title** `string`
>
> The title of the task
>
> **due\_date** `string`
>
> The task’s due date (YYYY-MM-DD)
>
> **project\_id** `integer`
>
> The ID of a project
>
> **assignee\_id** `integer`
>
> The assignee user ID
>
> **description** `string`
>
> The description of the task
>
> **parent\_task\_id** `integer`
>
> The ID of a parent task; cannot be a subtask’s ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update task in project plan
>
> **Slug:** `PIPEDRIVE_UPDATE_TASK_IN_PROJECT_PLAN`
>
> Updates a task phase or group in a project.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the project
>
> **taskId** `integer` *required*
>
> The ID of the task
>
> **group\_id** `integer`
>
> The ID of a group on a project board
>
> **phase\_id** `integer`
>
> The ID of a phase on a project board
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a team
>
> **Slug:** `PIPEDRIVE_UPDATE_TEAM`
>
> Updates an existing team and returns the updated object.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the team
>
> **name** `string`
>
> The team name
>
> **users** `array`
>
> The list of user IDs
>
> **manager\_id** `integer`
>
> The team manager ID
>
> **active\_flag** `integer`
>
> Flag that indicates whether the team is active (0/1)
>
> **description** `string`
>
> The team description
>
> **deleted\_flag** `integer`
>
> Flag that indicates whether the team is deleted (0/1)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update user details
>
> **Slug:** `PIPEDRIVE_UPDATE_USER`
>
> Tool to update user details in Pipedrive. Use when you need to activate or deactivate a user account. Requires admin-level permissions.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user to update
>
> **active\_flag** `boolean` *required*
>
> Indicates user status. false = Not activated, true = Activated
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update user details
>
> **Slug:** `PIPEDRIVE_UPDATE_USER_DETAILS`
>
> Updates the properties of a user. Currently, only `active_flag` can be updated.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The ID of the user
>
> **active\_flag** `boolean` *required*
>
> Whether the user is active or not. `false` = Not activated, `true` = Activated
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Who Am I
>
> **Slug:** `PIPEDRIVE_WHO_AM_I`
>
> Return the identity (name, email) of the connected Pipedrive account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

## Triggers

> [accordion] New Deal Received Trigger
>
> **Slug:** `PIPEDRIVE_NEW_DEAL_TRIGGER`
>
> **Type:** webhook
>
> Triggered when a new deal is created in Pipedrive
>
> #### Payload
>
> **currency** `string`
>
> Currency of the deal
>
> **id** `string`
>
> ID of the deal
>
> **stage\_id** `string`
>
> ID of the pipeline stage
>
> **status** `string`
>
> Status of the deal
>
> **title** `string`
>
> Title of the deal
>
> **user\_id** `string`
>
> ID of the user who created the deal
>
> **value** `string`
>
> Value of the deal

> [accordion] New Note Received Trigger
>
> **Slug:** `PIPEDRIVE_NEW_NOTE_TRIGGER`
>
> **Type:** webhook
>
> Triggered when a new note is created in Pipedrive
>
> #### Payload
>
> **add\_time** `string`
>
> Time when the note was added
>
> **content** `string`
>
> Content of the note
>
> **deal\_id** `string`
>
> ID of the associated deal
>
> **id** `string`
>
> ID of the note
>
> **org\_id** `string`
>
> ID of the associated organization
>
> **person\_id** `string`
>
> ID of the associated person
>
> **user\_id** `string`
>
> ID of the user who created the note

> [accordion] New Organization Received Trigger
>
> **Slug:** `PIPEDRIVE_NEW_ORGANIZATION_TRIGGER`
>
> **Type:** webhook
>
> Triggered when a new organization is created in Pipedrive
>
> #### Payload
>
> **address** `string`
>
> Address of the organization
>
> **email** `string`
>
> Email of the organization
>
> **id** `string`
>
> ID of the organization
>
> **name** `string`
>
> Name of the organization
>
> **owner\_id** `string`
>
> ID of the organization owner
>
> **phone** `string`
>
> Phone number of the organization
>
> **web** `string`
>
> Website of the organization
