[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">August 29, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p>We are applying limits to filter conditions and removing 3 conditions from the Filters API to ensure a reliable experience and quick responses for all users.</p>\n      \n      <p><b>What is changing?</b></p>\n      <p>We will be implementing a limit to the number of conditions a filter can have via the <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Filters#addFilter\" target=\"_self\">POST /filters</a></code> and <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Filters#updateFilter\" target=\"_self\">PUT /filters/{id}</a></code> endpoints.\n        The new limit will be <b>16 conditions per filter</b>.</p>\n      \n      <p>If a filter is being added or updated to include more than 16 conditions, the request will fail and a <code>400</code> error response, similar to this one, will be returned:</p>\n      <div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\"><button type=\"button\">JSON</button></div><div class=\"CodeTabs-inner\"><pre><code class=\"rdmd-code lang-json theme-light\" data-lang=\"json\" name=\"\"><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><div class=\"cm-s-neo\">{\n  <span class=\"cm-property\">\"success\"</span>: <span class=\"cm-atom\">false</span>,\n  <span class=\"cm-property\">\"error\"</span>: <span class=\"cm-string\">\"Filter is allowed to have at most 16 conditions\"</span>,\n  <span class=\"cm-property\">\"error_info\"</span>: <span class=\"cm-string\">\"Please check developers.pipedrive.com for more information about Pipedrive API.\"</span>,\n  <span class=\"cm-property\">\"data\"</span>: <span class=\"cm-atom\">null</span>,\n  <span class=\"cm-property\">\"additional_data\"</span>: <span class=\"cm-atom\">null</span>\n}\n</div></code></pre></div></div>\n      \n      <p>In addition to the limit, we have now deprecated and will soon stop supporting the following filter conditions from the <code>conditions</code> body parameter of \n        the <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Filters#addFilter\" target=\"_self\">POST /filters</a></code> and <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Filters#updateFilter\" target=\"_self\">PUT /filters/{id}</a></code> endpoint:</p>\n      <ul>\n        <li><code>LIKE '%$'</code> <i>(ends with)</i></li>\n        <li><code>NOT LIKE '%$%'</code> <i>(does not contain)</i></li>\n        <li><code>NOT LIKE '%$'</code> <i>(does not end with)</i></li>\n      </ul>\n      \n      <p>The new limit and removal of the 3 conditions will go into effect \n        on <b>August 29, 2022</b>. We advise you to review the filters you have \n        created and make sure that they adhere to the changes.</p>\n      \n\t\t\t<p><b>Why is it changing?</b></p>\n      <p>We've added new limits to the Filters API because complex filters can \n        easily cause system overload. As we are constantly improving our systems, \n        these limits will help to continuously support the excellent performance \n        of our API to apps and users.</p>\n      \n      <p><b>Who will be affected?</b></p>\n      <p>Everyone who is using the specified <code>POST</code> and <code>PUT</code> endpoints to add and/or modify filters or has filters with more than 16 conditions in place.</p>\n      <p>If you have any questions or comments, let us know in <a href=\"https://devcommunity.pipedrive.com/\" target=\"_self\">the Developer’s Community</a>.</p>\n    </div>\n  \n  \n</div>\n\n"
}
[/block]

We are applying limits to filter conditions and removing 3 conditions from the Filters API to ensure a reliable experience and quick responses for all users.

Changes in filter conditions for Filters API

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">August 21, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p>We have now deprecated and will soon be removing the following 2 GlobalMessages API endpoints:</p>\n      <ul>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/GlobalMessages#getGlobalMessages\" target=\"_self\">GET /globalMessages</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/GlobalMessages#deleteGlobalMessage\" target=\"_self\">DELETE /globalMessages/{id}</a></code></li>\n      </ul>\n      \n      <p>We strongly advise you to avoid using these 2 deprecated endpoints.</p>\n      \n      <p><b>Why are we removing it?</b></p>\n      <p>These two endpoints are a legacy way of getting and dismissing global messages. Due to a change in business logic, we have deprecated the old GlobalMessages functionality and a new solution has been implemented within the Pipedrive web app, which users have been migrated to.</p>\n      \n      <p>As our goal is to continuously improve our API and keep it consistent with our web app, we will, therefore, be removing these endpoints.</p>\n      \n      <p>If you have any questions or comments, let us know in <a href=\"https://devcommunity.pipedrive.com/\" target=\"_self\">the Developer’s Community</a>.</p>\n    </div>\n</div>\n\n"
}
[/block]

{"product": ["Developer Platform"], "features": ["GlobalMessages"]}

Removal of GlobalMessages API

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">August 16, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p>We are announcing a new rate limit for the Search API to improve our API performance. The new limit will go into effect on August 16, 2022.</p>\n      \n      <p><b>What is changing?</b></p>\n      <p>The Search API will have a new rate limit of <b>10 requests per 2 seconds</b> per <code>api_token</code> and for OAuth apps using <code>access_token</code>. The change affects the following 7 endpoints:</p>\n      <ul>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#searchDeals\" target=\"_self\">GET /deals/search</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItem\" target=\"_self\">GET /itemSearch</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItemByField\" target=\"_self\">GET /itemSearch/field</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Leads#searchLeads\" target=\"_self\">GET /leads/search</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#searchOrganization\" target=\"_self\">GET /organizations/search</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#searchPersons\" target=\"_self\">GET /persons/search</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Products#searchProducts\" target=\"_self\">GET /products/search</a></code></li>\n      </ul>\n      \n      <p>All other Pipedrive API endpoints, besides the 7 Search API endpoints, will continue to adhere to general <a href=\"https://pipedrive.readme.io/docs/core-api-concepts-rate-limiting\" target=\"_self\">rate limiting rules</a>.</p>\n      \n      <p><b>Why is it changing?</b></p>\n      <p>We are introducing the granularity of the API rate limiting for Search API to ensure a reliable experience for all of our users.</p>\n      <p>The new Search API rate limit allows us to deliver a higher quality service through a more stable API platform with quicker responses. It also serves to protect our systems from data overload by  increasing equality and efficiency in performance distribution.</p>\n      \n      <p><b>Who will be affected?</b></p>\n      <p>Everyone who is using the listed Search API endpoints to access data.</p>\n      <p>If you have any questions or comments, let us know in <a href=\"https://devcommunity.pipedrive.com/\" target=\"_self\">the Developer’s Community</a>.</p>\n    </div>\n</div>\n\n"
}
[/block]

Announcing Search API rate limit

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">August 8, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p><b>What is changing?</b></p>\n      <p>We are removing the <code>matches_filters</code> field from the <code>additional_data</code> section of the success response of the following POST and PUT endpoints:</p>\n      <ul>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#addDeal\" target=\"_self\">POST /deals</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#addOrganization\" target=\"_self\">POST /organizations</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#addPerson\" target=\"_self\">POST /persons</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#updateDeal\" target=\"_self\">PUT /deals/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#updateOrganization\" target=\"_self\">PUT /organizations/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#updatePerson\" target=\"_self\">PUT /persons/{id}</a></code></li>\n      </ul>\n      \n      <p><b>Why is it changing?</b></p>\n      <p>The goal behind removing the field is to improve the performance of the above mentioned endpoints.</p>\n      \n      <p><b>Who will be affected?</b></p>\n      <p>Everyone who is using the <code>matches_filters</code> response field data from these POST and PUT endpoints.</p>\n      \n      <p>If you have any questions or comments, let us know in <a href=\"https://devcommunity.pipedrive.com/\" target=\"_self\">the Developer’s Community</a>.</p>\n    </div>\n</div>\n"
}
[/block]

{"product": ["API"], "features": ["Deals", "Persons", "Organizations"]}

Removal of the <code>matches_filters</code> response field from POST and PUT endpoints

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">May 31, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p>1. We have removed the <code>required</code>label from the <code>name</code> body parameter to reflect reality for the following two endpoints:\n      </p>\n      <ul>\n         \t<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#updatePerson\" target=\"_self\">PUT /persons/{id}</a></code></li>\n          <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/ProductFields#updateProductField\" target=\"_self\">PUT /productFields/{id}</a></code></li>\n      </ul>\n      \n      <p>2. Regarding the <a href=\"https://developers.pipedrive.com/changelog/post/breaking-change-in-teams-api-path-url\" target=\"_self\">breaking change in Teams API path URL</a> we announced on May 10, 2022, we have deprecated all LegacyTeams API endpoints as we are preparing for an upgraded version of the Teams API.\n        </p>\n    </div>\n</div>"
}
[/block]

{"product": ["Developer Platform"], "features": ["Persons", "Products", "Teams"]}

May 2022 release notes

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">July 11, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p>The Teams feature, currently available for Professional and Enterprise tier users, allows to form groups of users within the organization for more efficient management.</p>\n      \n      <p><b>What is changing?</b></p>\n      <p><a href=\"https://developers.pipedrive.com/docs/api/v1/LegacyTeams\" target=\"_self\">Teams API</a> will remain available, but on a different path URL: \n        the current <b><code>/teams/</code></b> path will be replaced by the <b><code>/legacyTeams/</code></b> path.</p>\n      \n      <p>For example, the endpoint for <a href=\"https://developers.pipedrive.com/docs/api/v1/LegacyTeams#getTeam\" target=\"_self\">getting a single team</a>:</p>\n      <ul>\n        <li>Previous path: <code>https://&lt;companydomain&gt;.pipedrive.com/v1/teams/{id}</code></li>\n        <li>New path: <code>https://&lt;companydomain&gt;.pipedrive.com/v1/legacyTeams/{id}</code></li>\n      </ul>\n      \n      <p>Therefore, we are asking you to migrate all Teams-related requests over to the new <code>/legacyTeams/</code> path, as we will stop supporting the <code>/teams/</code> path on July 11, 2022.</p>\n      \n      <p>The functionality and <a href=\"https://pipedrive.readme.io/docs/marketplace-scopes-and-permissions-explanations\" target=\"_self\">OAuth scopes</a> of all the Teams API endpoints will remain the same.</p>\n      \n      <p><b>Why is it changing?</b></p>\n      <p>We are preparing for an upgraded version of the Teams API, which requires migrating the current functionality to a new path URL.</p>\n      \n      <p><b>Who will be affected?</b></p>\n      <p>Everyone who is using the Teams API to access, modify and/or add data.</p>\n      <p>If you have any questions or comments, let us know in <a href=\"https://devcommunity.pipedrive.com/\" target=\"_self\">the Developer’s Community</a>.</p>\n  \n  </div>\n</div>"
}
[/block]

{"product": ["API"], "features": ["Teams"]}

Breaking change in Teams API path URLs

Breaking change in Teams API path URL

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">May 5, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p>Integrate a <b>messaging service directly</b> into Pipedrive with our new Messaging app extension. \n        To enable apps to do this, we’ve created a <b>deep integration point</b> with our <a href=\"https://support.pipedrive.com/en/article/messaging-inbox\">Messaging inbox</a> inside the Leads Inbox of Pipedrive.\n</p>\n      <figure><span aria-label=\"Messaging inbox - active conversation with details from different apps\" class=\"img\" role=\"button\" tabindex=\"0\"><img src=\"https://files.readme.io/2034d9e-app_inbox_2.png\" alt=\"Messaging inbox - active conversation with details from different apps\" title=\"app_inbox (2).png\" class=\"\" align=\"\" caption=\"\" height=\"auto\" width=\"auto\" loading=\"lazy\">\n        <span autofocus=\"\" class=\"lightbox\" role=\"dialog\" tabindex=\"0\"><span class=\"lightbox-inner\"><img src=\"https://files.readme.io/2034d9e-app_inbox_2.png\" title=\"Click to close...\" class=\"lightbox-img\" align=\"\" caption=\"\" height=\"auto\" width=\"auto\" alt=\"Messaging inbox - active conversation with details from different apps\" loading=\"lazy\">\n          </span></span></span><figcaption><p>Messaging inbox - active conversation with details from different apps</p></figcaption></figure>\n      \n      <p>By using the messaging extension, app users can send, view and delete messages right inside Pipedrive, whilst all of their communications are synced with the messaging service. Apps with messaging extension can also be shared company-wide.\n</p>\n      <p>The extension and its access to Messaging inbox go through a manifest-based connection and public API endpoints. This makes the extension controllable from the provider’s side (user action done in service), the user’s side (action done in Pipedrive, sent to messaging service) and the app’s side (action done by app to mimic service conditions in Pipedrive).\n</p>\n      <p>With this extension, we’ve added a couple of new things: \n</p>\n      <p><b>In Developer Documentation</b></p>\n      <p>You can find a complete overview of \n        <a href=\"https://pipedrive.readme.io/docs/messaging-app-extension\" target=\"_self\">Messaging app extension</a>, \n        <a href=\"https://pipedrive.readme.io/docs/implementing-messaging-app-extension\" target=\"_self\">how to implement the manifest</a> and \n       <a href=\"https://pipedrive.readme.io/docs/error-codes-and-troubleshooting-for-messaging-app-extension\" target=\"_self\">custom error codes as well as troubleshooting</a>.\n</p>\n       <p><b>In API Reference</b></p>\n      <p>We’ve added the <a href=\"https://developers.pipedrive.com/docs/api/v1/Channels\" target=\"_self\">Channels API</a> with 4 new endpoints. The endpoints enable you to manage and interact with the channel’s conversations, participants and messages inside the Pipedrive Messaging inbox. Apps can call these endpoints to forward received messages and conversations from the messaging provider service to Pipedrive.</p>\n      <ul>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Channels#addChannel\" target=\"_self\">POST /v1/channels</a></code></li>\n         <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Channels#receiveMessage\" target=\"_self\">POST /v1/channels/messages/receive</a></code></li>\n         <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Channels#deleteChannel\" target=\"_self\">DELETE /v1/channels/{id}</a></code></li>\n         <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Channels#deleteConversation\" target=\"_self\">DELETE /v1/channels/{channel-id}/conversations/{conversation-id}</a></code></li>\n      </ul>\n       <p><b>In OAuth Scopes </b></p>\n      <p>We’ve added the <code>Messengers integrations</code> access scope, which is key to building the Messaging app extension. By enabling this scope for your app, users can now grant your app access to their data for connection building between messaging channels. This scope also covers all Channels API endpoints mentioned above.\n</p>\n        </div>\n</div>"
}
[/block]

New feature: Messaging app extension

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">April 28, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p>1. We included <code>Workflow automation</code> as a success response field for the <code><a href=\"https://developers.pipedrive.com/docs/api/v1/LeadSources#getLeadSources\" target=\"_self\">GET /leadSources</a></code> endpoint.\n      </p>\n      \n      <p>2. <code>Leadbooster</code> is now documented as a possible lead source for the <a href=\"https://developers.pipedrive.com/docs/api/v1/LeadSources\" target=\"_self\">LeadSources API</a>:\n        </p>\n\t\t\t\t<ul>\n         \t<li><code>Leadbooster</code> - the value assigned to leads sourced from the Chatbot feature</li>\n      </ul>\n      \n      <p>3. We updated the data type label of the <code>visible_to</code> body parameter from <code>number</code> to <code>string</code> to reflect reality for the following endpoints:\n        </p>\n\t\t\t<ul>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#addDeal\" target=\"_self\">POST /deals</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#updateDeal\" target=\"_self\">PUT /deals/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Leads#addLead\" target=\"_self\">POST /leads</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Leads#updateLead\" target=\"_self\">PATCH /leads/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#addOrganization\" target=\"_self\">POST /organizations</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#updateOrganization\" target=\"_self\">PUT /organizations/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#addPerson\" target=\"_self\">POST /persons</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#updatePerson\" target=\"_self\">PUT /persons/{id}</a></code></li>\n      </ul>\n     \n      <p>4. The <code>visible_to</code> response field’s documentation was updated from <code>number</code> to <code>string</code> type to reflect reality for 2 endpoints:\n      </p>\n      <ul>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#addOrganization\" target=\"_self\">POST /organizations</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#updateOrganization\" target=\"_self\">PUT /organizations/{id}</a></code></li>\n        </ul>\n    </div>\n</div>"
}
[/block]

April release notes

April 2022 release notes

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">March 31, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p>1. We documented the <code>everyone</code> query parameter for the <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Stages#getStage\" target=\"_self\">GET /stages/{id}</a></code> endpoint.\n</p>\n      <p>2. The <code>pipeline_id</code> body parameter is now documented for the <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#addDeal\" target=\"_self\">POST /deals</a></code> endpoint.\n</p>\n      <p>3. We updated the description of the <code>rotten_flag</code> parameter from <b>integer</b> to <b>boolean</b> type to reflect reality for  the <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Stages#addStage\" target=\"_self\">POST /stages </a></code> and <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Stages#updateStage\" target=\"_self\">PUT /stages/{id}</a></code> endpoints.\n</p>\n      <p>4. The <code>leads:full</code> scope now allows apps to have access to the <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Leads#searchLeads\" target=\"_self\">GET leads/search</a></code> endpoint.\n</p>\n       \n       </div>\n</div>"
}
[/block]

{"product": ["API", "Authentication"], "features": ["Stages", "Deals", "Leads", "Scopes"]}

March 2022 release notes

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">March 23, 2022</span>\n    </div>\n    <div class=\"change-area\">\n      <p>We have added a new Billing resource with one new <code>GET</code> endpoint to our API Reference.\n</p>\n      <p><b>What is being added?\n</b></p>\n      <p>The new Billing API currently includes the following endpoint:\n</p>\n      <ul><li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Billing#getCompanyAddons\" target=\"_self\">GET /billing/subscriptions/addons\n        </a>\n        </code>\n        </li>\n      </ul>\n      <p>The endpoint has been also added to the <code>users:read</code> <a href=\"https://pipedrive.readme.io/docs/marketplace-scopes-and-permissions-explanations\" target=\"_self\"> OAuth scope</a>.\n</p>\n      \n      <p>The new endpoint allows an integration to retrieve the add-ons of a single company. \n        This means that the app will be able to get information around access to additional Pipedrive products the customer is using (e.g. Campaigns, LeadBooster) \n        and seamlessly provide the customer with more functionality directly inside the integration.\n</p>\n      \n       </div>\n</div>"
}
[/block]

{"product": ["API", "Authorization"], "features": ["Billing", "Scopes"]}

Contents

Changelog

Announced changes

Subscribe to our Changelog

Subscribe to our Changelog

Subscribe to our
Changelog