<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">April 12, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="removal-of-the-subscriptions-api"></div>
        <div class="heading-text"><div id="removal-of-the-subscriptions-api" class="heading-anchor_backwardsCompatibility">
          </div>Removal of the Subscriptions API</div>
        <a aria-label="Skip link to Removal of the Subscriptions API" class="heading-anchor-icon fa fa-anchor" 
           href="#removal-of-the-subscriptions-api"></a></h3>
      
        
    <p><strong>UPDATE</strong>: After further testing, our team has found an alternative method and will NO LONGER be removing these endpoints. For detailed information see the full announcement <a href="https://pipedrive.readme.io/docs/changelog#restoration-of-the-subscriptions-api" target="_self">here</a>.</p>


      <p>We have now deprecated and will soon be removing the following nine Subscriptions API endpoints:</p>

<p><ul>
          <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#getSubscription">GET /subscriptions/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#findSubscriptionByDeal">GET /subscriptions/find/{dealId}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#getSubscriptionPayments">GET /subscriptions/{id}/payments</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#addRecurringSubscription">POST /subscriptions/recurring</a></code></li>
       <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#addSubscriptionInstallment">POST /subscriptions/installment</a></code></li>
       <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#updateRecurringSubscription">PUT /subscriptions/recurring/{id}</a></code></li>
       <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#updateSubscriptionInstallment">PUT /subscriptions/installment/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#cancelRecurringSubscription">PUT /subscriptions/recurring/{id}/cancel}</a></code></li>
      <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#deleteSubscription">DELETE /subscriptions/{id}</a></code></li>
      </ul></p>
<p>We strongly advise you to avoid the use of these 9 deprecated API endpoints.</p>

   <p><b>What's going to change?</b></p>
  <p>The <a href="https://www.pipedrive.com/en/features/recurring-revenue" target="_self">Recurring Revenue</a> and Payment Schedule features will be substituted with a new renewal deals functionality and therefore the previously mentioned features will no longer be available as a standalone functionality.</p>
  
  <p><b>Why?</b></p>
  <p>We wish to deliver the best possible sales oriented approach. Having that in mind, we need to move the functionalities of the Recurring Revenue and the Payment Schedules closer to Deals and Pipeline processes to truly support sales success of Pipedrive users.
</p>
   <br>
      <p class="published-on"><i>Published on February 4, 2021</i></p>
</div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">April 12, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="removal-of-the-subscriptions-api"></div>
        <div class="heading-text"><div id="removal-of-the-subscriptions-api" class="heading-anchor_backwardsCompatibility">
          </div>Removal of the Subscriptions API</div>
        <a aria-label="Skip link to Removal of the Subscriptions API" class="heading-anchor-icon fa fa-anchor" 
           href="#removal-of-the-subscriptions-api"></a></h3>
      
        
    <p><strong>UPDATE</strong>: After further testing, our team has found an alternative method and will NO LONGER be removing these endpoints. For detailed information see the full announcement <a href="/changelog/post/restoration-of-the-subscriptions-api" target="_self">here</a>.</p>


      <p>We have now deprecated and will soon be removing the following nine Subscriptions API endpoints:</p>

<p><ul>
          <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#getSubscription">GET /subscriptions/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#findSubscriptionByDeal">GET /subscriptions/find/{dealId}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#getSubscriptionPayments">GET /subscriptions/{id}/payments</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#addRecurringSubscription">POST /subscriptions/recurring</a></code></li>
       <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#addSubscriptionInstallment">POST /subscriptions/installment</a></code></li>
       <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#updateRecurringSubscription">PUT /subscriptions/recurring/{id}</a></code></li>
       <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#updateSubscriptionInstallment">PUT /subscriptions/installment/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#cancelRecurringSubscription">PUT /subscriptions/recurring/{id}/cancel}</a></code></li>
      <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Subscriptions#deleteSubscription">DELETE /subscriptions/{id}</a></code></li>
      </ul></p>
<p>We strongly advise you to avoid the use of these 9 deprecated API endpoints.</p>

   <p><b>What's going to change?</b></p>
  <p>The <a href="https://www.pipedrive.com/en/features/recurring-revenue" target="_self">Recurring Revenue</a> and Payment Schedule features will be substituted with a new renewal deals functionality and therefore the previously mentioned features will no longer be available as a standalone functionality.</p>
  
  <p><b>Why?</b></p>
  <p>We wish to deliver the best possible sales oriented approach. Having that in mind, we need to move the functionalities of the Recurring Revenue and the Payment Schedules closer to Deals and Pipeline processes to truly support sales success of Pipedrive users.
</p>
   <br>
      <p class="published-on"><i>Published on February 4, 2021</i></p>
</div>
</div>


Removal of the Subscriptions API

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">March 1, 2021</span>
    </div>
    <div class="change-area">
       <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="change-in-behavior-of-4-bulk-delete-endpoints"></div>
        <div class="heading-text"><div id="change-in-behavior-of-4-bulk-delete-endpoints" class="heading-anchor_backwardsCompatibility">
          </div>Change in behavior of 4 bulk DELETE endpoints</div>
        <a aria-label="Skip link to Change in behavior of 4 bulk DELETE endpoints" class="heading-anchor-icon fa fa-anchor" 
           href="#change-in-behavior-of-4-bulk-delete-endpoints"></a></h3>
      
      
         
      <p><b>What will change?</b></p>
      <p>Four Pipedrive API bulk <code>DELETE</code> endpoints will be limited to deleting up to 1000 items per request.
</p>
       <p>The requests made against the following four bulk <code>DELETE</code> endpoints will be serviced slower than before. The processing speed will be based on the number of items being deleted and the worst case scenario being at most <b>20 seconds for a request with 1000 items</b>.</p>
       <p>The change affects the following four API endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Activities#deleteActivities">DELETE /activities</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#deleteDeals">DELETE /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Organizations#deleteOrganizations">DELETE /organizations</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#deletePersons">DELETE /persons</a></code></li>
      </ul>
      <br>
      <p><b>Why?</b></p>
       <p>We are making technical improvements in the backend to increase the reliability of features reacting to changes made to entities. Examples of those features include Workflow Automation and Webhooks. In the current state, in rare cases when performing large bulk deletes, a reaction could be lost.</p>
       <p>The bulk deletes will be done asynchronously in the background by going through items 1 by 1. This will make it possible for all related features to react to changes in a reliable way.</p>
      <p><b>Who is affected?</b></p>
       <p>Anyone depending on the behavior of those previously listed four endpoints in any way is affected. In case you are using the four endpoints in your code or 3rd party app/integration, please make sure that you complete the following two steps as soon as possible (or by March 1, 2021 the latest):
</p>
      <ul>
        <li> send the maximum of 1000 items at once</li>
        <li> your code can handle the requests taking longer to finish
</li>
      </ul>

      <br>
      <p class="published-on"><i>Published on January 29, 2021</i></p>
</div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">March 1, 2021</span>
    </div>
    <div class="change-area">
       <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="change-in-behavior-of-4-bulk-delete-endpoints"></div>
        <div class="heading-text"><div id="change-in-behavior-of-4-bulk-delete-endpoints" class="heading-anchor_backwardsCompatibility">
          </div>Change in behavior of 4 bulk DELETE endpoints</div>
        <a aria-label="Skip link to Change in behavior of 4 bulk DELETE endpoints" class="heading-anchor-icon fa fa-anchor" 
           href="#change-in-behavior-of-4-bulk-delete-endpoints"></a></h3>
      
      
         
      <p><b>What will change?</b></p>
      <p>Four Pipedrive API bulk <code>DELETE</code> endpoints will be limited to deleting up to 1000 items per request.
</p>
       <p>The requests made against the following four bulk <code>DELETE</code> endpoints will be serviced slower than before. The processing speed will be based on the number of items being deleted and the worst case scenario being at most <b>20 seconds for a request with 1000 items</b>.</p>
       <p>The change affects the following four API endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Activities#deleteActivities">DELETE /activities</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#deleteDeals">DELETE /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Organizations#deleteOrganizations">DELETE /organizations</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#deletePersons">DELETE /persons</a></code></li>
      </ul>
      <br>
      <p><b>Why?</b></p>
       <p>We are making technical improvements in the backend to increase the reliability of features reacting to changes made to entities. Examples of those features include Workflow Automation and Webhooks. In the current state, in rare cases when performing large bulk deletes, a reaction could be lost.</p>
       <p>The bulk deletes will be done asynchronously in the background by going through items 1 by 1. This will make it possible for all related features to react to changes in a reliable way.</p>
      <p><b>Who is affected?</b></p>
       <p>Anyone depending on the behavior of those previously listed four endpoints in any way is affected. In case you are using the four endpoints in your code or 3rd party app/integration, please make sure that you complete the following two steps as soon as possible (or by March 1, 2021 the latest):
</p>
      <ul>
        <li> send the maximum of 1000 items at once</li>
        <li> your code can handle the requests taking longer to finish
</li>
      </ul>

      <br>
      <p class="published-on"><i>Published on January 29, 2021</i></p>
</div>
</div>


Change in behavior of 4 bulk DELETE endpoints

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 27, 2021</span>
    </div>
    <div class="change-area">
       <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="companydomain-to-replace-api-proxy-in-API-requests"></div>
        <div class="heading-text"><div id="companydomain-to-replace-api-proxy-in-API-requests" class="heading-anchor_backwardsCompatibility">
          </div><code>companydomain</code> to replace <code>api-proxy</code> in API requests</div>
        <a aria-label="Skip link to companydomain to replace api-proxy in API requests" class="heading-anchor-icon fa fa-anchor" 
           href="#companydomain-to-replace-api-proxy-in-API-requests"></a></h3>
      
         
      <p><b>What?
</b></p>
      
      <p> From now on, we’re <b>suggesting</b> you to use <code>https://companydomain.pipedrive.com/api/v1/</code> API domains for making requests to Pipedrive API. Read more about Pipedrive API URL naming convention <a href="https://pipedrive.readme.io/docs/core-api-concepts-requests#url-naming" target="_self">here</a>.</p>

      <p><b>Why?</b></p>
<p>This suggestion comes in addition to the change announced on <a href="https://pipedrive.readme.io/docs/changelog#new-parameter-in-oauth-/oauth/token/-responses" target="_self">Feb 21 last year</a> when we introduced a new parameter <code>api_domain</code> in OAuth 2.0 <code>/oauth/token</code> responses for our external developers to receive up-to-date <code>company_domain</code> and <code>api_domain</code> every time one makes the initial request to get the tokens or when one refreshes a token. Also, using the <code>companydomain</code> prefix should make your requests to our API faster.</p>
<p class="published-on"><i>Published on January 27, 2021</i></p>
</div>
</div>
`}</HTMLBlock>


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 27, 2021</span>
    </div>
    <div class="change-area">
       <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="companydomain-to-replace-api-proxy-in-API-requests"></div>
        <div class="heading-text"><div id="companydomain-to-replace-api-proxy-in-API-requests" class="heading-anchor_backwardsCompatibility">
          </div><code>companydomain</code> to replace <code>api-proxy</code> in API requests</div>
        <a aria-label="Skip link to companydomain to replace api-proxy in API requests" class="heading-anchor-icon fa fa-anchor" 
           href="#companydomain-to-replace-api-proxy-in-API-requests"></a></h3>
      
         
      <p><b>What?
</b></p>
      
      <p> From now on, we’re <b>suggesting</b> you to use <code>https://companydomain.pipedrive.com/api/v1/</code> API domains for making requests to Pipedrive API. Read more about Pipedrive API URL naming convention <a href="https://pipedrive.readme.io/docs/core-api-concepts-requests#url-naming" target="_self">here</a>.</p>

      <p><b>Why?</b></p>
<p>This suggestion comes in addition to the change announced on <a href="/changelog/post/new-parameter-in-oauth-/oauth/token/-responses" target="_self">Feb 21 last year</a> when we introduced a new parameter <code>api_domain</code> in OAuth 2.0 <code>/oauth/token</code> responses for our external developers to receive up-to-date <code>company_domain</code> and <code>api_domain</code> every time one makes the initial request to get the tokens or when one refreshes a token. Also, using the <code>companydomain</code> prefix should make your requests to our API faster.</p>
<p class="published-on"><i>Published on January 27, 2021</i></p>
</div>
</div>


<code>companydomain</code> to replace <code>api-proxy</code> in API requests

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 15, 2021</span>
    </div>
    <div class="change-area">
        <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="new-parameters-in-app-actions-urls"></div>
        <div class="heading-text"><div id="new-parameters-in-app-actions-urls" class="heading-anchor_backwardsCompatibility">
          </div>New parameters in App actions' URLs </div>
        <a aria-label="Skip link to New parameters in App actions' URLs " class="heading-anchor-icon fa fa-anchor" 
           href="#new-parameters-in-app-actions-urls"></a></h3>
      
        
      <p>App actions triggered from the Activity list view will now have additional parameters <code>activity_type</code>, <code>activity_start_date</code> and <code> activity_end_date</code> added to the URL of the action to describe a <b>filter</b> that has been applied to the selected activities. These parameters will be included in the <code>filter</code> parameter.</p>
<p>The <code>activity_type</code> parameter will always be included in the URL for actions from the Activity list view,  <code>activity_start_date</code> and <code> activity_end_date</code> will be added only when they are selected by the user.</p>
      <p>

      For more information, see <a href="https://pipedrive.readme.io/docs/app-extensions-actions">App actions' guide</a>.
      </p>
      
          <p class="published-on"><i>Published on January 15, 2021</i></p>
    </div>
</div>
`}</HTMLBlock>

{"product": ["App extensions"], "features": ["App actions"]}


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 15, 2021</span>
    </div>
    <div class="change-area">
        <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="new-parameters-in-app-actions-urls"></div>
        <div class="heading-text"><div id="new-parameters-in-app-actions-urls" class="heading-anchor_backwardsCompatibility">
          </div>New parameters in App actions' URLs </div>
        <a aria-label="Skip link to New parameters in App actions' URLs " class="heading-anchor-icon fa fa-anchor" 
           href="#new-parameters-in-app-actions-urls"></a></h3>
      
        
      <p>App actions triggered from the Activity list view will now have additional parameters <code>activity_type</code>, <code>activity_start_date</code> and <code> activity_end_date</code> added to the URL of the action to describe a <b>filter</b> that has been applied to the selected activities. These parameters will be included in the <code>filter</code> parameter.</p>
<p>The <code>activity_type</code> parameter will always be included in the URL for actions from the Activity list view,  <code>activity_start_date</code> and <code> activity_end_date</code> will be added only when they are selected by the user.</p>
      <p>

      For more information, see <a href="https://pipedrive.readme.io/docs/app-extensions-actions">App actions' guide</a>.
      </p>
      
          <p class="published-on"><i>Published on January 15, 2021</i></p>
    </div>
</div>


New parameters in App actions' URLs

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 12, 2021</span>
    </div>
    <div class="change-area">
      
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="updates-to-goals-api"></div>
        <div class="heading-text"><div id="updates-to-goals-api" class="heading-anchor_backwardsCompatibility">
          </div>Updates to Goals API  </div>
        <a aria-label="Skip link to Updates to Goals API " class="heading-anchor-icon fa fa-anchor" 
           href="#updates-to-goals-api"></a></h3>
      
         
       <p>
      We’re introducing three updates to our <a href="https://developers.pipedrive.com/docs/api/v1/#!/Goals">Goals API</a>:
      </p>
      <p>
        1. There’s a new goal type -  <code>revenue_forecast</code>. This type of goal allows users to track their revenue forecast.</p>
      <p>2. Goals don’t need to have an end date. You can set up infinite, open-ended goals by setting <code>end</code> to <code>null</code>.</p>
        <p>3. <code>report_ids</code> array is now a part of the response of the Goals API. This array includes IDs of reports used in <a href="https://support.pipedrive.com/hc/en-us/articles/360001930658-Insights-feature">the Insights feature</a> to highlight the goal’s progress over time. Every goal should have at least one report attached to it.</p>
       <p class="published-on"><i>Published on January 12, 2021</i></p>
</div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 12, 2021</span>
    </div>
    <div class="change-area">
      
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="updates-to-goals-api"></div>
        <div class="heading-text"><div id="updates-to-goals-api" class="heading-anchor_backwardsCompatibility">
          </div>Updates to Goals API  </div>
        <a aria-label="Skip link to Updates to Goals API " class="heading-anchor-icon fa fa-anchor" 
           href="#updates-to-goals-api"></a></h3>
      
         
       <p>
      We’re introducing three updates to our <a href="https://developers.pipedrive.com/docs/api/v1/#!/Goals">Goals API</a>:
      </p>
      <p>
        1. There’s a new goal type -  <code>revenue_forecast</code>. This type of goal allows users to track their revenue forecast.</p>
      <p>2. Goals don’t need to have an end date. You can set up infinite, open-ended goals by setting <code>end</code> to <code>null</code>.</p>
        <p>3. <code>report_ids</code> array is now a part of the response of the Goals API. This array includes IDs of reports used in <a href="https://support.pipedrive.com/hc/en-us/articles/360001930658-Insights-feature">the Insights feature</a> to highlight the goal’s progress over time. Every goal should have at least one report attached to it.</p>
       <p class="published-on"><i>Published on January 12, 2021</i></p>
</div>
</div>


Updates to Goals API

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label"><b>Effective from:</b></span><br>
        <span class="from-date"><b>January 7, 2021</b></span>
    </div>
    <div class="change-area">
       <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="phone-calls-integration-oauth-scope"></div>
        <div class="heading-text"><div id="phone-calls-integration-oauth-scope" class="heading-anchor_backwardsCompatibility">
          </div>Phone calls integration OAuth scope</div>
        <a aria-label="Skip link to Phone calls integration OAuth scope " class="heading-anchor-icon fa fa-anchor" 
           href="#phone-calls-integration-oauth-scope"></a></h3>
      
     
      <p><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs" target="_self">CallLogs</a></code> endpoints have now been added to a new scope <b>Phone calls integration</b> which is available for OAuth apps. The scope will allow apps to enable advanced call integration features like logging call duration and other metadata and play call recordings inside Pipedrive.</p>

<p>You can find the following endpoints of the <code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs" target="_self">CallLogs</a></code> resource under this scope:</p>
<p><ul>
          <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#addCallLog">POST /callLogs</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#deleteCallLog">DELETE /callLogs/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#addCallLogAudioFile">POST /callLogs/{id}/recordings</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#getUserCallLogs">GET /callLogs</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#getCallLog">GET /callLogs/{id}</a></code></li>
      </ul></p>
<p>You can read more about the scopes and permission explanations <a href="https://pipedrive.readme.io/docs/marketplace-scopes-and-permissions-explanations">here</a>.</p> 
     <p>If you wish to update the scopes of an already approved or published app, be sure to <a href="https://pipedrive.readme.io/docs/marketplace-updating-the-existing-app#changing-the-scopes">learn how changing the scopes will affect your app's existing users</a>.</p>
    
       <p class="published-on"><i>Published on January 7, 2021</i></p>
    </div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label"><b>Effective from:</b></span><br>
        <span class="from-date"><b>January 7, 2021</b></span>
    </div>
    <div class="change-area">
       <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="phone-calls-integration-oauth-scope"></div>
        <div class="heading-text"><div id="phone-calls-integration-oauth-scope" class="heading-anchor_backwardsCompatibility">
          </div>Phone calls integration OAuth scope</div>
        <a aria-label="Skip link to Phone calls integration OAuth scope " class="heading-anchor-icon fa fa-anchor" 
           href="#phone-calls-integration-oauth-scope"></a></h3>
      
     
      <p><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs" target="_self">CallLogs</a></code> endpoints have now been added to a new scope <b>Phone calls integration</b> which is available for OAuth apps. The scope will allow apps to enable advanced call integration features like logging call duration and other metadata and play call recordings inside Pipedrive.</p>

<p>You can find the following endpoints of the <code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs" target="_self">CallLogs</a></code> resource under this scope:</p>
<p><ul>
          <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#addCallLog">POST /callLogs</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#deleteCallLog">DELETE /callLogs/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#addCallLogAudioFile">POST /callLogs/{id}/recordings</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#getUserCallLogs">GET /callLogs</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#getCallLog">GET /callLogs/{id}</a></code></li>
      </ul></p>
<p>You can read more about the scopes and permission explanations <a href="https://pipedrive.readme.io/docs/marketplace-scopes-and-permissions-explanations">here</a>.</p> 
     <p>If you wish to update the scopes of an already approved or published app, be sure to <a href="https://pipedrive.readme.io/docs/marketplace-updating-the-existing-app#changing-the-scopes">learn how changing the scopes will affect your app's existing users</a>.</p>
    
       <p class="published-on"><i>Published on January 7, 2021</i></p>
    </div>
</div>


Phone calls integration OAuth scope

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 6, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="get-/itemsearch-now-supports-returning-leads"></div>
        <div class="heading-text"><div id="get-/itemsearch-now-supports-returning-leads" class="heading-anchor_backwardsCompatibility">
          </div><code>GET/itemSearch</code> now supports returning Leads</div>
        <a aria-label="Skip link to GET/itemSearch now supports returning Leads" class="heading-anchor-icon fa fa-anchor" 
           href="#get-/itemsearch-now-supports-returning-leads"></a></h3>
      
      
        
      <p><b>What will change?</b></p>
       
<p><code><a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItem">GET /itemSearch</a></code> now supports returning <b>Leads</b> in <code>related_items</code> for Organizations and Persons that are linked to it. When the <code>search_for_related_items</code>for <code><a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItem">GET /itemSearch</a></code> is set to <code>true</code>, the response will include up to 100 newest related <b>Leads</b> in addition to up to a 100 <b>Deals</b> for each found Person and Organization.
   
</p>

  <p class="published-on"><i>Published on January 6, 2021</i></p>
    </div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 6, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="get-/itemsearch-now-supports-returning-leads"></div>
        <div class="heading-text"><div id="get-/itemsearch-now-supports-returning-leads" class="heading-anchor_backwardsCompatibility">
          </div><code>GET/itemSearch</code> now supports returning Leads</div>
        <a aria-label="Skip link to GET/itemSearch now supports returning Leads" class="heading-anchor-icon fa fa-anchor" 
           href="#get-/itemsearch-now-supports-returning-leads"></a></h3>
      
      
        
      <p><b>What will change?</b></p>
       
<p><code><a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItem">GET /itemSearch</a></code> now supports returning <b>Leads</b> in <code>related_items</code> for Organizations and Persons that are linked to it. When the <code>search_for_related_items</code>for <code><a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItem">GET /itemSearch</a></code> is set to <code>true</code>, the response will include up to 100 newest related <b>Leads</b> in addition to up to a 100 <b>Deals</b> for each found Person and Organization.
   
</p>

  <p class="published-on"><i>Published on January 6, 2021</i></p>
    </div>
</div>


<code>GET/itemSearch</code> now supports returning Leads

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 4, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="breaking change in get /files endpoint"></div>
        <div class="heading-text"><div id="breaking change in get /files endpoint" class="heading-anchor_backwardsCompatibility">
          </div>Breaking change in <code>GET /files</code> endpoint</div>
        <a aria-label="Skip link to Breaking change in GET /fiels endpoint" class="heading-anchor-icon fa fa-anchor" 
           href="#breaking change in get /files endpoint"></a></h3>
      
        
      <p><b>What will change?</b></p>
       
<p>We are going to change the definition of the sort parameter of <code><a href="https://developers.pipedrive.com/docs/api/v1/Files#getFiles">GET /files</a></code> endpoint. We’re going to allow sorting by 2 columns only (<code>id</code>, <code>update_time</code>) and restrict sorting by more than 1 column at the same time (e.g. <code>field_name_1</code> ASC, <code>field_name_2</code> DESC won’t work anymore).</p>
      <p><b>Why?</b></p>
<p>We are optimising our sorting operations together with moving to a new service for files management.</p>
      <p><b>Who is affected?</b></p>
      <p>Anyone doing queries to <code><a href="https://developers.pipedrive.com/docs/api/v1/Files#getFiles">GET /files</a></code> using sorting by <code>file_type</code>.</p>

  <p class="published-on"><i>Published on December 17, 2020</i></p>
    </div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 4, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="breaking change in get /files endpoint"></div>
        <div class="heading-text"><div id="breaking change in get /files endpoint" class="heading-anchor_backwardsCompatibility">
          </div>Breaking change in <code>GET /files</code> endpoint</div>
        <a aria-label="Skip link to Breaking change in GET /fiels endpoint" class="heading-anchor-icon fa fa-anchor" 
           href="#breaking change in get /files endpoint"></a></h3>
      
        
      <p><b>What will change?</b></p>
       
<p>We are going to change the definition of the sort parameter of <code><a href="https://developers.pipedrive.com/docs/api/v1/Files#getFiles">GET /files</a></code> endpoint. We’re going to allow sorting by 2 columns only (<code>id</code>, <code>update_time</code>) and restrict sorting by more than 1 column at the same time (e.g. <code>field_name_1</code> ASC, <code>field_name_2</code> DESC won’t work anymore).</p>
      <p><b>Why?</b></p>
<p>We are optimising our sorting operations together with moving to a new service for files management.</p>
      <p><b>Who is affected?</b></p>
      <p>Anyone doing queries to <code><a href="https://developers.pipedrive.com/docs/api/v1/Files#getFiles">GET /files</a></code> using sorting by <code>file_type</code>.</p>

  <p class="published-on"><i>Published on December 17, 2020</i></p>
    </div>
</div>


Breaking change in <code>GET /files</code> endpoint

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 11, 2020</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="bug fix in date and datetime fields"></div>
        <div class="heading-text"><div id="bug fix in date and datetime fields" class="heading-anchor_backwardsCompatibility">
          </div>Bug fix in <code>date</code> and <code>datetime</code> fields</div>
        <a aria-label="Skip link to Bug fix in date and datetime fields" class="heading-anchor-icon fa fa-anchor" 
           href="#bug fix in date and datetime fields"></a></h3>

      <p>There was an issue with <code>date</code> and <code>datetime</code> fields, which affected Deals, Persons, Organizations, Products and Activities resources. When filtering by <code>date</code> and/or <code>datetime</code> with the operators <code><</code>, <code>></code>, <code><=</code>, <code>>=</code> it might have returned rows with an empty date (<code>0000-00-00</code>) and/or empty datetime (<code>0000-00-00 00:00:00</code>). We made the server response more strict, which means that now when filtering the same way the rows with empty date will always be excluded.</p>
        <p>The issue has now been fixed.</p>
<p>Please let us know if you have any questions by replying to the forum thread <a href="https://devcommunity.pipedrive.com/t/bug-fix-in-date-and-datetime-fields/3517">here</a>.</p>

  <p class="published-on"><i>Published on December 11, 2020</i></p>
    </div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 11, 2020</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="bug fix in date and datetime fields"></div>
        <div class="heading-text"><div id="bug fix in date and datetime fields" class="heading-anchor_backwardsCompatibility">
          </div>Bug fix in <code>date</code> and <code>datetime</code> fields</div>
        <a aria-label="Skip link to Bug fix in date and datetime fields" class="heading-anchor-icon fa fa-anchor" 
           href="#bug fix in date and datetime fields"></a></h3>

      <p>There was an issue with <code>date</code> and <code>datetime</code> fields, which affected Deals, Persons, Organizations, Products and Activities resources. When filtering by <code>date</code> and/or <code>datetime</code> with the operators <code><</code>, <code>></code>, <code><=</code>, <code>>=</code> it might have returned rows with an empty date (<code>0000-00-00</code>) and/or empty datetime (<code>0000-00-00 00:00:00</code>). We made the server response more strict, which means that now when filtering the same way the rows with empty date will always be excluded.</p>
        <p>The issue has now been fixed.</p>
<p>Please let us know if you have any questions by replying to the forum thread <a href="https://devcommunity.pipedrive.com/t/bug-fix-in-date-and-datetime-fields/3517">here</a>.</p>

  <p class="published-on"><i>Published on December 11, 2020</i></p>
    </div>
</div>


Bug fix in <code>date</code> and <code>datetime</code> fields

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 28, 2020</span>
    </div>
    <div class="change-area">
        <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="removal of two endpoints from the /users resource"></div>
        <div class="heading-text"><div id="removal of two endpoints from the /users resource" class="heading-anchor_backwardsCompatibility">
          </div>Removal of two endpoints from the <code>/Users</code> resource</div>
        <a aria-label="Skip link to Removal of two endpoints from the /Users resource" class="heading-anchor-icon fa fa-anchor" 
           href="#removal of two endpoints from the /users resource"></a></h3>

      <p>We have now deprecated and will be removing the following two endpoints from the <code><a href="https://developers.pipedrive.com/docs/api/v1/#!/Users">Users</a></code> resource:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#getUserBlacklistedEmails">GET /users/{id}/blacklistedEmails</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#addUserBlacklistedEmail">POST /users/{id}/blacklistedEmails</a></code></li>
      </ul>
<p>In case you are still using the above-mentioned API endpoints in your code or 3rd party app/integration, please remove any dependency on these endpoints <b>by December 28, 2020</b>.</p>

  <p class="published-on"><i>Published on November 23, 2020</i></p>
    </div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 28, 2020</span>
    </div>
    <div class="change-area">
        <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="removal of two endpoints from the /users resource"></div>
        <div class="heading-text"><div id="removal of two endpoints from the /users resource" class="heading-anchor_backwardsCompatibility">
          </div>Removal of two endpoints from the <code>/Users</code> resource</div>
        <a aria-label="Skip link to Removal of two endpoints from the /Users resource" class="heading-anchor-icon fa fa-anchor" 
           href="#removal of two endpoints from the /users resource"></a></h3>

      <p>We have now deprecated and will be removing the following two endpoints from the <code><a href="https://developers.pipedrive.com/docs/api/v1/#!/Users">Users</a></code> resource:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#getUserBlacklistedEmails">GET /users/{id}/blacklistedEmails</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#addUserBlacklistedEmail">POST /users/{id}/blacklistedEmails</a></code></li>
      </ul>
<p>In case you are still using the above-mentioned API endpoints in your code or 3rd party app/integration, please remove any dependency on these endpoints <b>by December 28, 2020</b>.</p>

  <p class="published-on"><i>Published on November 23, 2020</i></p>
    </div>
</div>


Contents

Changelog

Announced changes

Subscribe to our Changelog

Subscribe to our Changelog

Subscribe to our
Changelog