Skip to main content
Server path: /pipedrive-deals | Type: Application | PCID required: Yes

Tools

ToolDescription
pipedrive_deals_add_dealAdd a new deal
pipedrive_deals_add_deal_fieldCreate one deal field
pipedrive_deals_add_deal_field_optionsAdd deal field options in bulk
pipedrive_deals_add_deal_followerAdd a follower to a deal
pipedrive_deals_add_deal_productAdd a product to a deal
pipedrive_deals_add_many_deal_productsAdd multiple products to a deal
pipedrive_deals_convert_deal_to_leadConvert a deal to a lead
pipedrive_deals_convert_lead_to_dealConvert a lead to a deal
pipedrive_deals_delete_additional_discountDelete a discount from a deal
pipedrive_deals_delete_dealDelete a deal
pipedrive_deals_delete_deal_fieldDelete one deal field
pipedrive_deals_delete_deal_field_optionsDelete deal field options in bulk
pipedrive_deals_delete_deal_followerDelete a follower from a deal
pipedrive_deals_delete_deal_productDelete an attached product from a deal
pipedrive_deals_delete_installmentDelete an installment from a deal
pipedrive_deals_delete_many_deal_productsDelete many products from a deal
pipedrive_deals_get_additional_discountsList discounts added to a deal
pipedrive_deals_get_archived_dealsGet all archived deals
pipedrive_deals_get_dealGet details of a deal
pipedrive_deals_get_deal_conversion_statusGet Deal conversion status
pipedrive_deals_get_deal_fieldGet one deal field
pipedrive_deals_get_deal_fieldsGet all deal fields
pipedrive_deals_get_deal_followersList followers of a deal
pipedrive_deals_get_deal_followers_changelogList followers changelog of a deal
pipedrive_deals_get_deal_productsList products attached to a deal
pipedrive_deals_get_dealsGet all deals
pipedrive_deals_get_installmentsList installments added to a list of deals
pipedrive_deals_get_lead_conversion_statusGet Lead conversion status
pipedrive_deals_get_productsGet deal products of several deals
pipedrive_deals_post_additional_discountAdd a discount to a deal
pipedrive_deals_post_installmentAdd an installment to a deal
pipedrive_deals_search_dealsSearch deals
pipedrive_deals_search_leadsSearch leads
pipedrive_deals_update_additional_discountUpdate a discount added to a deal
pipedrive_deals_update_dealUpdate a deal
pipedrive_deals_update_deal_fieldUpdate one deal field
pipedrive_deals_update_deal_field_optionsUpdate deal field options in bulk
pipedrive_deals_update_deal_productUpdate the product attached to a deal
pipedrive_deals_update_installmentUpdate an installment added to a deal

pipedrive_deals_add_deal

Add a new deal Parameters:
ParameterTypeRequiredDefaultDescription
archive_timestringNoThe 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_timestringNoThe date and time of closing the deal. Can only be set if deal status is won or lost.
currencystringNoThe currency associated with the deal
custom_fieldsobjectNoAn object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes
expected_close_datestringNoThe expected close date of the deal
is_archivedbooleanNoWhether the deal is archived or not
is_deletedbooleanNoWhether the deal is deleted or not
label_idsany[]NoThe IDs of labels assigned to the deal
lost_reasonstringNoThe reason for losing the deal. Can only be set if deal status is lost.
lost_timestringNoThe date and time of changing the deal status as lost. Can only be set if deal status is lost.
org_idintegerNoThe ID of the organization linked to the deal
owner_idintegerNoThe ID of the user who owns the deal
person_idintegerNoThe ID of the person linked to the deal
pipeline_idintegerNoThe ID of the pipeline associated with the deal
probabilitynumberNoThe success probability percentage of the deal
stage_idintegerNoThe ID of the deal stage
statusstringNoThe status of the deal
titlestringYesThe title of the deal
valuenumberNoThe value of the deal
visible_tointegerNoThe visibility of the deal
won_timestringNoThe 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:
ParameterTypeRequiredDefaultDescription
descriptionstringNoField description
field_namestringYesField name
field_typestringYesThe 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_fieldsobjectNoConfiguration for highlighting the field at specific stages.
optionsany[]NoField options (required for enum and set field types)
required_fieldsobjectNoRequired fields configuration for marking the field as mandatory when interacted with in the Pipedrive web UI.
ui_visibilityobjectNoUI 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:
ParameterTypeRequiredDefaultDescription
field_codestringYesThe unique code identifying the field
bodyany[]YesArray 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
user_idintegerYesThe ID of the user to add as a follower

pipedrive_deals_add_deal_product

Add a product to a deal Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
billing_frequencystringNoOnly 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_cyclesintegerNoOnly 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_datestringNoOnly available in Growth and above plans The billing start date. Must be between 10 years in the past and 10 years in the future
commentsstringNoThe comments of the product
discountnumberNoThe value of the discount. The discount_type field can be used to specify whether the value is an amount or a percentage
discount_typestringNoThe value of the discount. The discount_type field can be used to specify whether the value is an amount or a percentage
is_enabledbooleanNoWhether 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_pricenumberYesThe price value of the product
product_idintegerYesThe ID of the product
product_variation_idintegerNoThe ID of the product variation
quantitynumberYesThe quantity of the product
taxnumberNoThe product tax
tax_methodstringNoThe 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
dataany[]YesArray 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal to convert

pipedrive_deals_convert_lead_to_deal

Convert a lead to a deal Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID of the lead to convert
pipeline_idintegerNoThe 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_idintegerNoThe 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
discount_idstringYesThe ID of the discount

pipedrive_deals_delete_deal

Delete a deal Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal

pipedrive_deals_delete_deal_field

Delete one deal field Parameters:
ParameterTypeRequiredDefaultDescription
field_codestringYesThe unique code identifying the field

pipedrive_deals_delete_deal_field_options

Delete deal field options in bulk Parameters:
ParameterTypeRequiredDefaultDescription
field_codestringYesThe unique code identifying the field
bodyany[]YesArray 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
follower_idintegerYesThe ID of the following user

pipedrive_deals_delete_deal_product

Delete an attached product from a deal Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
product_attachment_idintegerYesThe product attachment ID

pipedrive_deals_delete_installment

Delete an installment from a deal Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
installment_idintegerYesThe ID of the installment

pipedrive_deals_delete_many_deal_products

Delete many products from a deal Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
idsstringYesComma-separated list of deal product IDs to delete. Maximum 100 IDs allowed.

pipedrive_deals_get_additional_discounts

List discounts added to a deal Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal

pipedrive_deals_get_archived_deals

Get all archived deals Parameters:
ParameterTypeRequiredDefaultDescription
filter_idintegerNoIf supplied, only deals matching the specified filter are returned
idsstringNoOptional 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_idintegerNoIf supplied, only deals owned by the specified user are returned. If filter_id is provided, this is ignored.
person_idintegerNoIf supplied, only deals linked to the specified person are returned. If filter_id is provided, this is ignored.
org_idintegerNoIf supplied, only deals linked to the specified organization are returned. If filter_id is provided, this is ignored.
pipeline_idintegerNoIf supplied, only deals in the specified pipeline are returned. If filter_id is provided, this is ignored.
stage_idintegerNoIf supplied, only deals in the specified stage are returned. If filter_id is provided, this is ignored.
statusstringNoOnly 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_sincestringNoIf 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_untilstringNoIf set, only deals with an update_time earlier than this time are returned. In RFC3339 format, e.g. 2025-01-01T10:20:00Z.
sort_bystringNoThe field to sort by. Supported fields: id, update_time, add_time.
sort_directionstringNoThe sorting direction. Supported values: asc, desc.
include_fieldsstringNoOptional 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_fieldsstringNoOptional 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.
limitintegerNoFor 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.
cursorstringNoFor 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
include_fieldsstringNoOptional 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_fieldsstringNoOptional 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of a deal
conversion_idstringYesThe ID of the conversion

pipedrive_deals_get_deal_field

Get one deal field Parameters:
ParameterTypeRequiredDefaultDescription
field_codestringYesThe unique code identifying the field
include_fieldsstringNoOptional 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:
ParameterTypeRequiredDefaultDescription
include_fieldsstringNoOptional 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
limitintegerNoFor 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.
cursorstringNoFor 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
limitintegerNoFor 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.
cursorstringNoFor 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
limitintegerNoFor 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.
cursorstringNoFor 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
cursorstringNoFor pagination, the marker (an opaque string value) representing the first item on the next page
limitintegerNoFor 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_bystringNoThe field to sort by. Supported fields: id, add_time, update_time, order_nr.
sort_directionstringNoThe sorting direction. Supported values: asc, desc.

pipedrive_deals_get_deals

Get all deals Parameters:
ParameterTypeRequiredDefaultDescription
filter_idintegerNoIf supplied, only deals matching the specified filter are returned
idsstringNoOptional 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_idintegerNoIf supplied, only deals owned by the specified user are returned. If filter_id is provided, this is ignored.
person_idintegerNoIf supplied, only deals linked to the specified person are returned. If filter_id is provided, this is ignored.
org_idintegerNoIf supplied, only deals linked to the specified organization are returned. If filter_id is provided, this is ignored.
pipeline_idintegerNoIf supplied, only deals in the specified pipeline are returned. If filter_id is provided, this is ignored.
stage_idintegerNoIf supplied, only deals in the specified stage are returned. If filter_id is provided, this is ignored.
statusstringNoOnly 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_sincestringNoIf 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_untilstringNoIf set, only deals with an update_time earlier than this time are returned. In RFC3339 format, e.g. 2025-01-01T10:20:00Z.
sort_bystringNoThe field to sort by. Supported fields: id, update_time, add_time.
sort_directionstringNoThe sorting direction. Supported values: asc, desc.
include_fieldsstringNoOptional 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_fieldsstringNoOptional 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.
limitintegerNoFor 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.
cursorstringNoFor 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:
ParameterTypeRequiredDefaultDescription
deal_idsany[]YesAn 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.
cursorstringNoFor pagination, the marker (an opaque string value) representing the first item on the next page
limitintegerNoFor 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_bystringNoThe field to sort by. Supported fields: id, billing_date, deal_id.
sort_directionstringNoThe sorting direction. Supported values: asc, desc.

pipedrive_deals_get_lead_conversion_status

Get Lead conversion status Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID of a lead
conversion_idstringYesThe ID of the conversion

pipedrive_deals_get_products

Get deal products of several deals Parameters:
ParameterTypeRequiredDefaultDescription
deal_idsany[]YesAn 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.
cursorstringNoFor pagination, the marker (an opaque string value) representing the first item on the next page
limitintegerNoFor 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_bystringNoThe field to sort by. Supported fields: id, deal_id, add_time, update_time, order_nr.
sort_directionstringNoThe sorting direction. Supported values: asc, desc.

pipedrive_deals_post_additional_discount

Add a discount to a deal Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
amountnumberYesThe discount amount. Must be a positive number (excluding 0).
descriptionstringYesThe name of the discount.
typestringYesDetermines whether the discount is applied as a percentage or a fixed amount.

pipedrive_deals_post_installment

Add an installment to a deal Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
amountnumberYesThe installment amount. Must be a positive number (excluding 0).
billing_datestringYesThe date on which the installment will be charged. Must be in the format YYYY-MM-DD.
descriptionstringYesThe name of the installment.

pipedrive_deals_search_deals

Search deals Parameters:
ParameterTypeRequiredDefaultDescription
termstringYesThe 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.
fieldsstringNoA 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_matchbooleanNoWhen enabled, only full exact matches against the given term are returned. It is <b>not</b> case sensitive.
person_idintegerNoWill filter deals by the provided person ID. The upper limit of found deals associated with the person is 2000.
organization_idintegerNoWill filter deals by the provided organization ID. The upper limit of found deals associated with the organization is 2000.
statusstringNoWill 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_fieldsstringNoSupports including optional fields in the results which are not provided by default Valid values: deal.cc_email
limitintegerNoFor 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.
cursorstringNoFor pagination, the marker (an opaque string value) representing the first item on the next page

pipedrive_deals_search_leads

Search leads Parameters:
ParameterTypeRequiredDefaultDescription
termstringYesThe 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.
fieldsstringNoA comma-separated string array. The fields to perform the search from. Defaults to all of them. Valid values: custom_fields, notes, title
exact_matchbooleanNoWhen enabled, only full exact matches against the given term are returned. It is <b>not</b> case sensitive.
person_idintegerNoWill filter leads by the provided person ID. The upper limit of found leads associated with the person is 2000.
organization_idintegerNoWill filter leads by the provided organization ID. The upper limit of found leads associated with the organization is 2000.
include_fieldsstringNoSupports including optional fields in the results which are not provided by default Valid values: lead.was_seen
limitintegerNoFor 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.
cursorstringNoFor 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
discount_idstringYesThe ID of the discount
amountnumberNoThe discount amount. Must be a positive number (excluding 0).
descriptionstringNoThe name of the discount.
typestringNoDetermines whether the discount is applied as a percentage or a fixed amount.

pipedrive_deals_update_deal

Update a deal Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
archive_timestringNoThe 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_timestringNoThe date and time of closing the deal. Can only be set if deal status is won or lost.
currencystringNoThe currency associated with the deal
custom_fieldsobjectNoAn object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes
expected_close_datestringNoThe expected close date of the deal
is_archivedbooleanNoWhether the deal is archived or not
is_deletedbooleanNoWhether the deal is deleted or not
label_idsany[]NoThe IDs of labels assigned to the deal
lost_reasonstringNoThe reason for losing the deal. Can only be set if deal status is lost.
lost_timestringNoThe date and time of changing the deal status as lost. Can only be set if deal status is lost.
org_idintegerNoThe ID of the organization linked to the deal
owner_idintegerNoThe ID of the user who owns the deal
person_idintegerNoThe ID of the person linked to the deal
pipeline_idintegerNoThe ID of the pipeline associated with the deal
probabilitynumberNoThe success probability percentage of the deal
stage_idintegerNoThe ID of the deal stage
statusstringNoThe status of the deal
titlestringNoThe title of the deal
valuenumberNoThe value of the deal
visible_tointegerNoThe visibility of the deal
won_timestringNoThe 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:
ParameterTypeRequiredDefaultDescription
field_codestringYesThe unique code identifying the field
descriptionstringNoField description
field_namestringNoField name
important_fieldsobjectNoConfiguration for highlighting the field at specific stages.
required_fieldsobjectNoRequired fields configuration for marking the field as mandatory when interacted with in the Pipedrive web UI.
ui_visibilityobjectNoUI 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:
ParameterTypeRequiredDefaultDescription
field_codestringYesThe unique code identifying the field
bodyany[]YesArray 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
product_attachment_idintegerYesThe ID of the deal-product (the ID of the product attached to the deal)
billing_frequencystringNoOnly 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_cyclesintegerNoOnly 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_datestringNoOnly available in Growth and above plans The billing start date. Must be between 10 years in the past and 10 years in the future
commentsstringNoThe comments of the product
discountnumberNoThe value of the discount. The discount_type field can be used to specify whether the value is an amount or a percentage
discount_typestringNoThe value of the discount. The discount_type field can be used to specify whether the value is an amount or a percentage
is_enabledbooleanNoWhether 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_pricenumberNoThe price value of the product
product_idintegerNoThe ID of the product
product_variation_idintegerNoThe ID of the product variation
quantitynumberNoThe quantity of the product
taxnumberNoThe product tax
tax_methodstringNoThe 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:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the deal
installment_idintegerYesThe ID of the installment
amountnumberNoThe installment amount. Must be a positive number (excluding 0).
billing_datestringNoThe date on which the installment will be charged. Must be in the format YYYY-MM-DD.
descriptionstringNoThe name of the installment.