<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">February 18, 2021</span>
    </div>
    <div class="change-area">
       <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="new-parameter-in-post-callLogs-endpoint"></div>
        <div class="heading-text"><div id="new-parameter-in-post-callLogs-endpoint" class="heading-anchor_backwardsCompatibility">
          </div>New parameter in <code>POST /callLogs</code> endpoint</div>
        <a aria-label="Skip link to New parameter in POST /callLogs endpoint" class="heading-anchor-icon fa fa-anchor" 
           href="#new-parameter-in-post-callLogs-endpoint"></a></h3>
      
      
       
      <p>We have added a new parameter <code>note</code> to the <code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#addCallLog" target="_self">POST /callLogs</a></code> endpoint.
        The <code>note</code> parameter allows you to add notes to call logs.</p>
      <br>
      <p class="published-on"><i>Published on February 18, 2021</i></p>
  </div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">February 18, 2021</span>
    </div>
    <div class="change-area">
       <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="new-parameter-in-post-callLogs-endpoint"></div>
        <div class="heading-text"><div id="new-parameter-in-post-callLogs-endpoint" class="heading-anchor_backwardsCompatibility">
          </div>New parameter in <code>POST /callLogs</code> endpoint</div>
        <a aria-label="Skip link to New parameter in POST /callLogs endpoint" class="heading-anchor-icon fa fa-anchor" 
           href="#new-parameter-in-post-callLogs-endpoint"></a></h3>
      
      
       
      <p>We have added a new parameter <code>note</code> to the <code><a href="https://developers.pipedrive.com/docs/api/v1/CallLogs#addCallLog" target="_self">POST /callLogs</a></code> endpoint.
        The <code>note</code> parameter allows you to add notes to call logs.</p>
      <br>
      <p class="published-on"><i>Published on February 18, 2021</i></p>
  </div>
</div>


New parameter in <code>POST /callLogs</code> endpoint

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">March 16, 2021</span>
    </div>
    <div class="change-area">
        <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="removal-of-a-static-field-from-users-api-response"></div>
        <div class="heading-text"><div id="removal-of-a-static-field-from-users-api-response" class="heading-anchor_backwardsCompatibility">
          </div>Removal of a static field from Users API response</div>
        <a aria-label="Skip link to Removal of a static field from Users API response" class="heading-anchor-icon fa fa-anchor" 
           href="#removal-of-a-static-field-from-users-api-response"></a></h3>
    
      <p><b>What is going to change?</b></p>
      <p>We will remove the field <code>activated</code> from the responses of the following Users API endpoints:
</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1Users#getUsers">GET /users</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#addUser">POST /users</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#findUsersByName">GET /users/find</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#getCurrentUser">GET /users/me</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#getUser">GET /users/{id}</a></code></li>
       <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#updateUser">PUT /users/{id}</a></code></li>
      </ul>
      
       <p><b>Why is it going to change?</b></p>
      <p>We are removing the <code>activated</code> field from these endpoints because the value of the field is static - it is always set to <code>true</code>.</p>
      <br>
      <p class="published-on"><i>Published on February 16, 2021</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">March 16, 2021</span>
    </div>
    <div class="change-area">
        <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="removal-of-a-static-field-from-users-api-response"></div>
        <div class="heading-text"><div id="removal-of-a-static-field-from-users-api-response" class="heading-anchor_backwardsCompatibility">
          </div>Removal of a static field from Users API response</div>
        <a aria-label="Skip link to Removal of a static field from Users API response" class="heading-anchor-icon fa fa-anchor" 
           href="#removal-of-a-static-field-from-users-api-response"></a></h3>
    
      <p><b>What is going to change?</b></p>
      <p>We will remove the field <code>activated</code> from the responses of the following Users API endpoints:
</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1Users#getUsers">GET /users</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#addUser">POST /users</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#findUsersByName">GET /users/find</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#getCurrentUser">GET /users/me</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#getUser">GET /users/{id}</a></code></li>
       <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#updateUser">PUT /users/{id}</a></code></li>
      </ul>
      
       <p><b>Why is it going to change?</b></p>
      <p>We are removing the <code>activated</code> field from these endpoints because the value of the field is static - it is always set to <code>true</code>.</p>
      <br>
      <p class="published-on"><i>Published on February 16, 2021</i></p>
  </div>
</div>


Removal of a static field from Users API response

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">February 15, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="introducing-new-app-extensions-embedded-app-actions"></div>
        <div class="heading-text"><div id="introducing-new-app-extensions-embedded-app-actions" class="heading-anchor_backwardsCompatibility">
          </div>Introducing new app extensions - Embedded app actions</div>
        <a aria-label="Skip link to Introducing new app extensions - Embedded app actions" class="heading-anchor-icon fa fa-anchor" 
           href="#introducing-new-app-extensions-embedded-app-actions"></a></h3>
     
      <p>Embedded app actions are a new type of app extensions that allow apps to provide a way for users to complete actions right inside Pipedrive without them being redirected. These types of app extensions enable users to, for example, add contacts to email campaigns, send SMS messages, change the status of a document, create tasks in project management tools, etc., without leaving Pipedrive.</p>
<p>
Embedded actions work by opening a modal window that can be customized with different <b>Blocks and Action buttons</b>. It can handle various types of user interactions, allowing to apply business and validation rules.
</p>
      
      <p>To start developing Embedded app actions, see our guides on the overview of <a href="https://pipedrive.readme.io/docs/app-extensions-embedded-actions" target="_self">Embedded app actions</a>, <a href="https://pipedrive.readme.io/docs/embedded-actions-component-library" target="_self">Component library</a>, and <a href="https://pipedrive.readme.io/docs/embedded-actions-user-interaction-handling" target="_self">User interaction handling</a>.</p>
      <br>
      <p class="published-on"><i>Published on February 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">February 15, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="introducing-new-app-extensions-embedded-app-actions"></div>
        <div class="heading-text"><div id="introducing-new-app-extensions-embedded-app-actions" class="heading-anchor_backwardsCompatibility">
          </div>Introducing new app extensions - Embedded app actions</div>
        <a aria-label="Skip link to Introducing new app extensions - Embedded app actions" class="heading-anchor-icon fa fa-anchor" 
           href="#introducing-new-app-extensions-embedded-app-actions"></a></h3>
     
      <p>Embedded app actions are a new type of app extensions that allow apps to provide a way for users to complete actions right inside Pipedrive without them being redirected. These types of app extensions enable users to, for example, add contacts to email campaigns, send SMS messages, change the status of a document, create tasks in project management tools, etc., without leaving Pipedrive.</p>
<p>
Embedded actions work by opening a modal window that can be customized with different <b>Blocks and Action buttons</b>. It can handle various types of user interactions, allowing to apply business and validation rules.
</p>
      
      <p>To start developing Embedded app actions, see our guides on the overview of <a href="https://pipedrive.readme.io/docs/app-extensions-embedded-actions" target="_self">Embedded app actions</a>, <a href="https://pipedrive.readme.io/docs/embedded-actions-component-library" target="_self">Component library</a>, and <a href="https://pipedrive.readme.io/docs/embedded-actions-user-interaction-handling" target="_self">User interaction handling</a>.</p>
      <br>
      <p class="published-on"><i>Published on February 15, 2021</i></p>
  </div>
</div>


Introducing new app extensions - Embedded app actions

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">February 11, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="new-field-in-deals-object"></div>
        <div class="heading-text"><div id="new-field-in-deals-object" class="heading-anchor_backwardsCompatibility">
          </div>New field in Deals object</div>
        <a aria-label="Skip link to New field in Deals object" class="heading-anchor-icon fa fa-anchor" 
           href="#new-field-in-deals-object"></a></h3>
      
         
      <p><b>What is going to change?</b></p>
      
      <p>A new field <code>renewal_type</code> will be added to the Deals object. This change affects all Deals endpoints which return the Deal object(s) in the response.</p>

<p>The possible values for the <code>renewal_type</code> field are <code>one_time</code>, <code>renewal</code>, and <code>new_business</code>.</p>
      <ul>
        <li><code>one_time</code> - Deal is a one-time transaction, no repetition of business transactions is expected.</li>
        <li><code>renewal</code> - the Deal is a new relationship with a new client. Such Deals will have renewals to prolong terms of agreement with customers. This Deal is a base/parent Deal for a group of Deals which will be the future renewals.
</li>
        <li><code>new_business</code> - the Deal is connected to the new business type of a Deal via a Deal group and is used by account management or customer success teams to keep track of upcoming prolongation of business relationships.
</li>
      </ul>
      <p>For example, to renew the Deal only once, add the following:</p>
      <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">{
   <span class="cm-meta">...</span>
   <span class="cm-string">"renewal_type"</span>: <span class="cm-string">"one_time"</span>,
   <span class="cm-meta">...</span>
}
</div></code></pre></div></div>
      
      <p><b>Why is it going to change?</b></p>
      <p>This change is linked to our <a href="https://pipedrive.readme.io/docs/changelog#removal-of-the-subscriptions-api" target="_self"> previous announcement</a> about substituting the Recurring Revenue and Payment Schedule features with an up-and-coming feature called Renewal management. In order to make it work, we need to add a new Deals field <code>renewal_type</code>.</p>
      <br>
      <p class="published-on"><i>Published on February 11, 2021</i></p>
</div>
</div>
`}</HTMLBlock>

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


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">February 11, 2021</span>
    </div>
    <div class="change-area">
      <h3 class="heading heading-3 header-scroll" align="">
      <div class="heading-anchor anchor waypoint" id="new-field-in-deals-object"></div>
        <div class="heading-text"><div id="new-field-in-deals-object" class="heading-anchor_backwardsCompatibility">
          </div>New field in Deals object</div>
        <a aria-label="Skip link to New field in Deals object" class="heading-anchor-icon fa fa-anchor" 
           href="#new-field-in-deals-object"></a></h3>
      
         
      <p><b>What is going to change?</b></p>
      
      <p>A new field <code>renewal_type</code> will be added to the Deals object. This change affects all Deals endpoints which return the Deal object(s) in the response.</p>

<p>The possible values for the <code>renewal_type</code> field are <code>one_time</code>, <code>renewal</code>, and <code>new_business</code>.</p>
      <ul>
        <li><code>one_time</code> - Deal is a one-time transaction, no repetition of business transactions is expected.</li>
        <li><code>renewal</code> - the Deal is a new relationship with a new client. Such Deals will have renewals to prolong terms of agreement with customers. This Deal is a base/parent Deal for a group of Deals which will be the future renewals.
</li>
        <li><code>new_business</code> - the Deal is connected to the new business type of a Deal via a Deal group and is used by account management or customer success teams to keep track of upcoming prolongation of business relationships.
</li>
      </ul>
      <p>For example, to renew the Deal only once, add the following:</p>
      <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">{
   <span class="cm-meta">...</span>
   <span class="cm-string">"renewal_type"</span>: <span class="cm-string">"one_time"</span>,
   <span class="cm-meta">...</span>
}
</div></code></pre></div></div>
      
      <p><b>Why is it going to change?</b></p>
      <p>This change is linked to our <a href="/changelog/post/removal-of-the-subscriptions-api" target="_self"> previous announcement</a> about substituting the Recurring Revenue and Payment Schedule features with an up-and-coming feature called Renewal management. In order to make it work, we need to add a new Deals field <code>renewal_type</code>.</p>
      <br>
      <p class="published-on"><i>Published on February 11, 2021</i></p>
</div>
</div>


New field in Deals object

<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>


<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>


Contents

Changelog

Announced changes

Subscribe to our Changelog

Subscribe to our Changelog

Subscribe to our
Changelog