📘

We've decided to retract the change to Deals API:

After careful consideration and valuable input from feedback from our API users, we have decided to retract the previously announced breaking change to the API.

Why are we retracting the change?

Upon reviewing the concerns raised, it became evident that the implementation of workarounds to get the exact time of deal closures would impose undue burdens on our technology partners and customers. Therefore, we have opted to maintain the current functionality, where the relevant fields will continue to return full datetime values as they presently do.

Will this retraction affect those using the existing API?

There will be no alterations to the current API behavior, and consequently, no adverse effects will arise for those utilizing the established client code.

What about those who have already made adjustments towards the new API behavior?

For those who have proactively updated their code in anticipation of the new API specifications, firstly, thank you for your proactive work. With this retraction, we advise reverting any modifications pertaining to the now-retracted change. The API will continue to function as it did prior to the announcement, negating the necessity for these adjustments.

We apologize for any inconvenience this announcement may have caused and are committed to ensuring that our API remains user-friendly. Your continued support, feedback and understanding are greatly appreciated.

We at Pipedrive are committed to ensuring that every customer and partner has a stable and trustworthy experience with all of our products and services. Therefore, we’ll continue with transparent communications regarding our API and developer platform.

What is changing?

The data type for the close_time, won_time, first_won_time, and lost_time response fields will be changed from datetime to date for the following Deals API endpoints:

• GET /deals
• GET /deals/timeline
• GET /deals/{id}
• POST /deals
• POST /deals/{id}/duplicate
• PUT /deals/{id}
• PUT /deals/{id}/merge
• GET /persons/{id}/deals
• GET /pipelines/{id}/deals
• GET /products/{id}/deals
• GET /recents
• GET /stages/{id}/deals

Similarly, the won_time and lost_time response fields will be changed from datetime to date in the GET /deals/collection endpoint.

The update will be gradually rolled out between December 6 and December 13, 2023.

If you have any questions or comments, let us know in the Developers' Community.