/pipedrive-deals | Type: Application | PCID required: Yes
Tools
pipedrive_deals_add_deal
Add a new deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
archive_time | string | No | — | 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. |
close_time | string | No | — | The date and time of closing the deal. Can only be set if deal status is won or lost. |
currency | string | No | — | The currency associated with the deal |
custom_fields | object | No | — | An object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes |
expected_close_date | string | No | — | The expected close date of the deal |
is_archived | boolean | No | — | Whether the deal is archived or not |
is_deleted | boolean | No | — | Whether the deal is deleted or not |
label_ids | any[] | No | — | The IDs of labels assigned to the deal |
lost_reason | string | No | — | The reason for losing the deal. Can only be set if deal status is lost. |
lost_time | string | No | — | The date and time of changing the deal status as lost. Can only be set if deal status is lost. |
org_id | integer | No | — | The ID of the organization linked to the deal |
owner_id | integer | No | — | The ID of the user who owns the deal |
person_id | integer | No | — | The ID of the person linked to the deal |
pipeline_id | integer | No | — | The ID of the pipeline associated with the deal |
probability | number | No | — | The success probability percentage of the deal |
stage_id | integer | No | — | The ID of the deal stage |
status | string | No | — | The status of the deal |
title | string | Yes | — | The title of the deal |
value | number | No | — | The value of the deal |
visible_to | integer | No | — | The visibility of the deal |
won_time | string | No | — | The date and time of changing the deal status as won. Can only be set if deal status is won. |
pipedrive_deals_add_deal_field
Create one deal field Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
description | string | No | — | Field description |
field_name | string | Yes | — | Field name |
field_type | string | Yes | — | 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 person 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</dd></table> |
important_fields | object | No | — | Configuration for highlighting the field at specific stages. |
options | any[] | No | — | Field options (required for enum and set field types) |
required_fields | object | No | — | Required fields configuration for marking the field as mandatory when interacted with in the Pipedrive web UI. |
ui_visibility | object | No | — | UI visibility settings for the field. Controls where the field appears in the Pipedrive web UI. |
pipedrive_deals_add_deal_field_options
Add deal field options in bulk Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
field_code | string | Yes | — | The unique code identifying the field |
body | any[] | Yes | — | Array of options to add. Each item must contain a label. At least one option is required. |
pipedrive_deals_add_deal_follower
Add a follower to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
user_id | integer | Yes | — | The ID of the user to add as a follower |
pipedrive_deals_add_deal_product
Add a product to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
billing_frequency | string | No | — | Only available in Growth and above plans How often a customer is billed for access to a service or product To set billing_frequency different than one-time, the deal must not have installments associated A deal can have up to 20 products attached with billing_frequency different than one-time |
billing_frequency_cycles | integer | No | — | Only available in Growth and above plans The number of times the billing frequency repeats for a product in a deal When billing_frequency is set to one-time, this field must be null When billing_frequency is set to weekly, this field cannot be null For all the other values of billing_frequency, null represents a product billed indefinitely Must be a positive integer less or equal to 208 |
billing_start_date | string | No | — | Only available in Growth and above plans The billing start date. Must be between 10 years in the past and 10 years in the future |
comments | string | No | — | The comments of the product |
discount | number | No | — | The value of the discount. The discount_type field can be used to specify whether the value is an amount or a percentage |
discount_type | string | No | — | The value of the discount. The discount_type field can be used to specify whether the value is an amount or a percentage |
is_enabled | boolean | No | — | Whether this product is enabled for the deal Not possible to disable the product if the deal has installments associated and the product is the last one enabled Not possible to enable the product if the deal has installments associated and the product is recurring |
item_price | number | Yes | — | The price value of the product |
product_id | integer | Yes | — | The ID of the product |
product_variation_id | integer | No | — | The ID of the product variation |
quantity | number | Yes | — | The quantity of the product |
tax | number | No | — | The product tax |
tax_method | string | No | — | 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. By default, the user setting value for tax options will be used. Changing this in one product affects the rest of the products attached to the deal |
pipedrive_deals_add_many_deal_products
Add multiple products to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
data | any[] | Yes | — | Array of products to attach to the deal. Each product object may have the following properties. |
pipedrive_deals_convert_deal_to_lead
Convert a deal to a lead Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal to convert |
pipedrive_deals_convert_lead_to_deal
Convert a lead to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The ID of the lead to convert |
pipeline_id | integer | No | — | The ID of a pipeline the created deal will be added to. By default, the deal will be added to the first stage of the specified pipeline. Please note that pipeline_id and stage_id should not be used together as pipeline_id will be ignored. |
stage_id | integer | No | — | The ID of a stage the created deal will be added to. Please note that a pipeline will be assigned automatically based on the stage_id. If omitted, the deal will be placed in the first stage of the default pipeline. |
pipedrive_deals_delete_additional_discount
Delete a discount from a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
discount_id | string | Yes | — | The ID of the discount |
pipedrive_deals_delete_deal
Delete a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
pipedrive_deals_delete_deal_field
Delete one deal field Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
field_code | string | Yes | — | The unique code identifying the field |
pipedrive_deals_delete_deal_field_options
Delete deal field options in bulk Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
field_code | string | Yes | — | The unique code identifying the field |
body | any[] | Yes | — | Array of option IDs to delete. Each item must contain an ID of the option to delete. At least one option ID is required. The entire request fails if any option does not exist. |
pipedrive_deals_delete_deal_follower
Delete a follower from a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
follower_id | integer | Yes | — | The ID of the following user |
pipedrive_deals_delete_deal_product
Delete an attached product from a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
product_attachment_id | integer | Yes | — | The product attachment ID |
pipedrive_deals_delete_installment
Delete an installment from a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
installment_id | integer | Yes | — | The ID of the installment |
pipedrive_deals_delete_many_deal_products
Delete many products from a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
ids | string | Yes | — | Comma-separated list of deal product IDs to delete. Maximum 100 IDs allowed. |
pipedrive_deals_get_additional_discounts
List discounts added to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
pipedrive_deals_get_archived_deals
Get all archived deals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filter_id | integer | No | — | If supplied, only deals matching the specified filter are returned |
ids | string | No | — | Optional comma separated string array of up to 100 entity ids to fetch. If filter_id is provided, this is ignored. If any of the requested entities do not exist or are not visible, they are not included in the response. |
owner_id | integer | No | — | If supplied, only deals owned by the specified user are returned. If filter_id is provided, this is ignored. |
person_id | integer | No | — | If supplied, only deals linked to the specified person are returned. If filter_id is provided, this is ignored. |
org_id | integer | No | — | If supplied, only deals linked to the specified organization are returned. If filter_id is provided, this is ignored. |
pipeline_id | integer | No | — | If supplied, only deals in the specified pipeline are returned. If filter_id is provided, this is ignored. |
stage_id | integer | No | — | If supplied, only deals in the specified stage are returned. If filter_id is provided, this is ignored. |
status | string | No | — | 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. Multiple statuses can be included as a comma separated array. If filter_id is provided, this is ignored. |
updated_since | string | No | — | If set, only deals with an update_time later than or equal to this time are returned. In RFC3339 format, e.g. 2025-01-01T10:20:00Z. |
updated_until | string | No | — | If set, only deals with an update_time earlier than this time are returned. In RFC3339 format, e.g. 2025-01-01T10:20:00Z. |
sort_by | string | No | — | The field to sort by. Supported fields: id, update_time, add_time. |
sort_direction | string | No | — | The sorting direction. Supported values: asc, desc. |
include_fields | string | No | — | Optional comma separated string array of additional fields to include Valid 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, source_lead_id |
custom_fields | string | No | — | Optional comma separated string array of custom fields keys to include. If you are only interested in a particular set of custom fields, please use this parameter for faster results and smaller response.<br/>A maximum of 15 keys is allowed. |
limit | integer | No | — | 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 | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
pipedrive_deals_get_deal
Get details of a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
include_fields | string | No | — | Optional comma separated string array of additional fields to include Valid 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, source_lead_id |
custom_fields | string | No | — | Optional comma separated string array of custom fields keys to include. If you are only interested in a particular set of custom fields, please use this parameter for faster results and smaller response.<br/>A maximum of 15 keys is allowed. |
pipedrive_deals_get_deal_conversion_status
Get Deal conversion status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of a deal |
conversion_id | string | Yes | — | The ID of the conversion |
pipedrive_deals_get_deal_field
Get one deal field Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
field_code | string | Yes | — | The unique code identifying the field |
include_fields | string | No | — | Optional comma separated string array of additional data namespaces to include in response Valid values: ui_visibility, important_fields, required_fields, ui_visibility,important_fields, ui_visibility,required_fields, important_fields,required_fields, ui_visibility,important_fields,required_fields |
pipedrive_deals_get_deal_fields
Get all deal fields Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
include_fields | string | No | — | Optional comma separated string array of additional data namespaces to include in response Valid values: ui_visibility, important_fields, required_fields, ui_visibility,important_fields, ui_visibility,required_fields, important_fields,required_fields, ui_visibility,important_fields,required_fields |
limit | integer | No | — | 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 | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
pipedrive_deals_get_deal_followers
List followers of a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
limit | integer | No | — | 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 | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
pipedrive_deals_get_deal_followers_changelog
List followers changelog of a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
limit | integer | No | — | 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 | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
pipedrive_deals_get_deal_products
List products attached to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
cursor | string | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
limit | integer | No | — | 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. |
sort_by | string | No | — | The field to sort by. Supported fields: id, add_time, update_time, order_nr. |
sort_direction | string | No | — | The sorting direction. Supported values: asc, desc. |
pipedrive_deals_get_deals
Get all deals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filter_id | integer | No | — | If supplied, only deals matching the specified filter are returned |
ids | string | No | — | Optional comma separated string array of up to 100 entity ids to fetch. If filter_id is provided, this is ignored. If any of the requested entities do not exist or are not visible, they are not included in the response. |
owner_id | integer | No | — | If supplied, only deals owned by the specified user are returned. If filter_id is provided, this is ignored. |
person_id | integer | No | — | If supplied, only deals linked to the specified person are returned. If filter_id is provided, this is ignored. |
org_id | integer | No | — | If supplied, only deals linked to the specified organization are returned. If filter_id is provided, this is ignored. |
pipeline_id | integer | No | — | If supplied, only deals in the specified pipeline are returned. If filter_id is provided, this is ignored. |
stage_id | integer | No | — | If supplied, only deals in the specified stage are returned. If filter_id is provided, this is ignored. |
status | string | No | — | 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. Multiple statuses can be included as a comma separated array. If filter_id is provided, this is ignored. |
updated_since | string | No | — | If set, only deals with an update_time later than or equal to this time are returned. In RFC3339 format, e.g. 2025-01-01T10:20:00Z. |
updated_until | string | No | — | If set, only deals with an update_time earlier than this time are returned. In RFC3339 format, e.g. 2025-01-01T10:20:00Z. |
sort_by | string | No | — | The field to sort by. Supported fields: id, update_time, add_time. |
sort_direction | string | No | — | The sorting direction. Supported values: asc, desc. |
include_fields | string | No | — | Optional comma separated string array of additional fields to include Valid 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, source_lead_id |
custom_fields | string | No | — | Optional comma separated string array of custom fields keys to include. If you are only interested in a particular set of custom fields, please use this parameter for faster results and smaller response.<br/>A maximum of 15 keys is allowed. |
limit | integer | No | — | 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 | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
pipedrive_deals_get_installments
List installments added to a list of deals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
deal_ids | any[] | Yes | — | An array of integers with the IDs of the deals for which the attached installments will be returned. A maximum of 100 deal IDs can be provided. |
cursor | string | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
limit | integer | No | — | 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. |
sort_by | string | No | — | The field to sort by. Supported fields: id, billing_date, deal_id. |
sort_direction | string | No | — | The sorting direction. Supported values: asc, desc. |
pipedrive_deals_get_lead_conversion_status
Get Lead conversion status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The ID of a lead |
conversion_id | string | Yes | — | The ID of the conversion |
pipedrive_deals_get_products
Get deal products of several deals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
deal_ids | any[] | Yes | — | An array of integers with the IDs of the deals for which the attached products will be returned. A maximum of 100 deal IDs can be provided. |
cursor | string | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
limit | integer | No | — | 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. |
sort_by | string | No | — | The field to sort by. Supported fields: id, deal_id, add_time, update_time, order_nr. |
sort_direction | string | No | — | The sorting direction. Supported values: asc, desc. |
pipedrive_deals_post_additional_discount
Add a discount to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
amount | number | Yes | — | The discount amount. Must be a positive number (excluding 0). |
description | string | Yes | — | The name of the discount. |
type | string | Yes | — | Determines whether the discount is applied as a percentage or a fixed amount. |
pipedrive_deals_post_installment
Add an installment to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
amount | number | Yes | — | The installment amount. Must be a positive number (excluding 0). |
billing_date | string | Yes | — | The date on which the installment will be charged. Must be in the format YYYY-MM-DD. |
description | string | Yes | — | The name of the installment. |
pipedrive_deals_search_deals
Search deals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
term | string | Yes | — | 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. |
fields | string | No | — | 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” target=“_blank” rel=“noopener noreferrer”>here</a>. Valid values: custom_fields, notes, title |
exact_match | boolean | No | — | When enabled, only full exact matches against the given term are returned. It is <b>not</b> case sensitive. |
person_id | integer | No | — | Will filter deals by the provided person ID. The upper limit of found deals associated with the person is 2000. |
organization_id | integer | No | — | Will filter deals by the provided organization ID. The upper limit of found deals associated with the organization is 2000. |
status | string | No | — | 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. |
include_fields | string | No | — | Supports including optional fields in the results which are not provided by default Valid values: deal.cc_email |
limit | integer | No | — | 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 | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
pipedrive_deals_search_leads
Search leads Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
term | string | Yes | — | 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. |
fields | string | No | — | A comma-separated string array. The fields to perform the search from. Defaults to all of them. Valid values: custom_fields, notes, title |
exact_match | boolean | No | — | When enabled, only full exact matches against the given term are returned. It is <b>not</b> case sensitive. |
person_id | integer | No | — | Will filter leads by the provided person ID. The upper limit of found leads associated with the person is 2000. |
organization_id | integer | No | — | Will filter leads by the provided organization ID. The upper limit of found leads associated with the organization is 2000. |
include_fields | string | No | — | Supports including optional fields in the results which are not provided by default Valid values: lead.was_seen |
limit | integer | No | — | 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 | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
pipedrive_deals_update_additional_discount
Update a discount added to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
discount_id | string | Yes | — | The ID of the discount |
amount | number | No | — | The discount amount. Must be a positive number (excluding 0). |
description | string | No | — | The name of the discount. |
type | string | No | — | Determines whether the discount is applied as a percentage or a fixed amount. |
pipedrive_deals_update_deal
Update a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
archive_time | string | No | — | 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. |
close_time | string | No | — | The date and time of closing the deal. Can only be set if deal status is won or lost. |
currency | string | No | — | The currency associated with the deal |
custom_fields | object | No | — | An object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes |
expected_close_date | string | No | — | The expected close date of the deal |
is_archived | boolean | No | — | Whether the deal is archived or not |
is_deleted | boolean | No | — | Whether the deal is deleted or not |
label_ids | any[] | No | — | The IDs of labels assigned to the deal |
lost_reason | string | No | — | The reason for losing the deal. Can only be set if deal status is lost. |
lost_time | string | No | — | The date and time of changing the deal status as lost. Can only be set if deal status is lost. |
org_id | integer | No | — | The ID of the organization linked to the deal |
owner_id | integer | No | — | The ID of the user who owns the deal |
person_id | integer | No | — | The ID of the person linked to the deal |
pipeline_id | integer | No | — | The ID of the pipeline associated with the deal |
probability | number | No | — | The success probability percentage of the deal |
stage_id | integer | No | — | The ID of the deal stage |
status | string | No | — | The status of the deal |
title | string | No | — | The title of the deal |
value | number | No | — | The value of the deal |
visible_to | integer | No | — | The visibility of the deal |
won_time | string | No | — | The date and time of changing the deal status as won. Can only be set if deal status is won. |
pipedrive_deals_update_deal_field
Update one deal field Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
field_code | string | Yes | — | The unique code identifying the field |
description | string | No | — | Field description |
field_name | string | No | — | Field name |
important_fields | object | No | — | Configuration for highlighting the field at specific stages. |
required_fields | object | No | — | Required fields configuration for marking the field as mandatory when interacted with in the Pipedrive web UI. |
ui_visibility | object | No | — | UI visibility settings for the field. Controls where the field appears in the Pipedrive web UI. |
pipedrive_deals_update_deal_field_options
Update deal field options in bulk Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
field_code | string | Yes | — | The unique code identifying the field |
body | any[] | Yes | — | Array of options to update. Each item must contain an ID and the updated label. At least one option is required. The entire request fails if any option does not exist. |
pipedrive_deals_update_deal_product
Update the product attached to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
product_attachment_id | integer | Yes | — | The ID of the deal-product (the ID of the product attached to the deal) |
billing_frequency | string | No | — | Only available in Growth and above plans How often a customer is billed for access to a service or product To set billing_frequency different than one-time, the deal must not have installments associated A deal can have up to 20 products attached with billing_frequency different than one-time |
billing_frequency_cycles | integer | No | — | Only available in Growth and above plans The number of times the billing frequency repeats for a product in a deal When billing_frequency is set to one-time, this field must be null When billing_frequency is set to weekly, this field cannot be null For all the other values of billing_frequency, null represents a product billed indefinitely Must be a positive integer less or equal to 208 |
billing_start_date | string | No | — | Only available in Growth and above plans The billing start date. Must be between 10 years in the past and 10 years in the future |
comments | string | No | — | The comments of the product |
discount | number | No | — | The value of the discount. The discount_type field can be used to specify whether the value is an amount or a percentage |
discount_type | string | No | — | The value of the discount. The discount_type field can be used to specify whether the value is an amount or a percentage |
is_enabled | boolean | No | — | Whether this product is enabled for the deal Not possible to disable the product if the deal has installments associated and the product is the last one enabled Not possible to enable the product if the deal has installments associated and the product is recurring |
item_price | number | No | — | The price value of the product |
product_id | integer | No | — | The ID of the product |
product_variation_id | integer | No | — | The ID of the product variation |
quantity | number | No | — | The quantity of the product |
tax | number | No | — | The product tax |
tax_method | string | No | — | 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. By default, the user setting value for tax options will be used. Changing this in one product affects the rest of the products attached to the deal |
pipedrive_deals_update_installment
Update an installment added to a deal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the deal |
installment_id | integer | Yes | — | The ID of the installment |
amount | number | No | — | The installment amount. Must be a positive number (excluding 0). |
billing_date | string | No | — | The date on which the installment will be charged. Must be in the format YYYY-MM-DD. |
description | string | No | — | The name of the installment. |

