<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 8, 2022</span>
    </div>
    <div class="change-area">
      
      <p>1. The <a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch">ItemSearch API</a> now supports searching for projects.</p>
      <p>For the <code><a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItem">GET /itemSearch</a></code> endpoint:</p>
      <ul>
        <li>the <code>item_types</code> query parameter has a new possible value <code>project</code></li>
        <li>the <code>fields</code> query parameter now allows you to use search from the following project fields: <code>custom_fields</code>, <code>notes</code>, <code>title</code>, <code>description</code></li>
      </ul>
      
      <p>For the <code><a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItemByField">GET /itemSearch/field</a></code> endpoint:</p>
      <ul>
        <li> the <code>field_type</code> query parameter supports a new value <code>projectField</code></li>
      </ul>
      
      <p>2. We have documented the <code>product_id</code> required body parameter for the <code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#addDealProduct">POST /deals/{id}/products</a></code> endpoint.</p>
      
      <p>3. Required labels were documented to reflect reality for the <code>assignee</code>, <code>type</code>, <code>expected_outcome</code>, <code>duration</code>, and <code>interval</code> body parameters of the <code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#addGoal">POST /goals</a></code> endpoint.</p>
      
      <p>4. We have removed the mistakenly documented <code>primary_email</code> body parameter from  <code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#addPerson">POST /persons</a></code> and <code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#updatePerson">PUT /persons/{id}</a></code> endpoints.</p>
      
     
       </div>
</div>
`}</HTMLBlock>

The latest improvements to our API Reference include projects support for ItemSearch API, adding the project_id body parameter for POST /deals/{id}/products, and documenting required labels for the body parameters of the POST /goals endpoint.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 8, 2022</span>
    </div>
    <div class="change-area">
      
      <p>1. The <a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch">ItemSearch API</a> now supports searching for projects.</p>
      <p>For the <code><a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItem">GET /itemSearch</a></code> endpoint:</p>
      <ul>
        <li>the <code>item_types</code> query parameter has a new possible value <code>project</code></li>
        <li>the <code>fields</code> query parameter now allows you to use search from the following project fields: <code>custom_fields</code>, <code>notes</code>, <code>title</code>, <code>description</code></li>
      </ul>
      
      <p>For the <code><a href="https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItemByField">GET /itemSearch/field</a></code> endpoint:</p>
      <ul>
        <li> the <code>field_type</code> query parameter supports a new value <code>projectField</code></li>
      </ul>
      
      <p>2. We have documented the <code>product_id</code> required body parameter for the <code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#addDealProduct">POST /deals/{id}/products</a></code> endpoint.</p>
      
      <p>3. Required labels were documented to reflect reality for the <code>assignee</code>, <code>type</code>, <code>expected_outcome</code>, <code>duration</code>, and <code>interval</code> body parameters of the <code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#addGoal">POST /goals</a></code> endpoint.</p>
      
      <p>4. We have removed the mistakenly documented <code>primary_email</code> body parameter from  <code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#addPerson">POST /persons</a></code> and <code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#updatePerson">PUT /persons/{id}</a></code> endpoints.</p>
      
     
       </div>
</div>


November 2022 release notes

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 17, 2023</span>
    </div>
    <div class="change-area">
      <p>UPDATE: The implementation of this change has been delayed. We apologize for any confusion or inconvenience this may have caused. From <b>March 29, 2023</b>, we are starting the gradual rollout of this change. Please refer to the <a href="https://developers.pipedrive.com/changelog/post/update-to-the-breaking-change-in-codelabelcode-response-fields-data-type-for-deals">updated announcement in Changelog</a> for further details.</p>
      
      <p><b>What is changing?</b></p>
      <p>From <b>January 17, 2023</b>, the data type of a <b>deal’s</b> <code>label</code> response field will be changed from <code>integer</code> to <code>string</code>:</p>
      <ul>
        <li>If the deal has a single label specified, the label ID will be returned as a <code>string</code></li>
        <li>If the deal has multiple labels specified, the label IDs will be returned as a comma separated <code>string</code></li>
      </ul>
      
      <p>The change affects the following deals-related endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDeals">GET /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDeal">GET /deals/{id} </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDealsTimeline">GET /deals/timeline</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganizationDeals">GET /organizations/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#getPersonDeals">GET /persons/{id}/deals </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Pipelines#getPipelineDeals">GET /pipelines/{id}/deals </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProductDeals">GET /products/{id}/deals </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Stages#getStageDeals">GET /stages/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#addDeal">POST /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#duplicateDeal">POST /deals/{id}/duplicate</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#updateDeal">PUT /deals/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#mergeDeals">PUT /deals/{id}/merge</a></code></li>
      </ul>
      
      <p>For the <code><a href="https://developers.pipedrive.com/docs/api/v1/DealFields#getDealFields">GET /dealFields</a></code> and <code><a href="https://developers.pipedrive.com/docs/api/v1/DealFields#getDealField">GET /dealFields/{id}</a></code> endpoints, the <code>field_type</code> associated with the <code>“key”: “label”</code> response object will be <code>set</code>, instead of the current <code>enum</code> type.</p>
      
      <p><b>Why is it changing?</b></p>
      <p>We are changing the data type of a deal’s label response field from <code>integer</code> to <code>string</code> to support the functionality of having multiple labels in one deal, which will be introduced in our web app.</p>
      
      <p><b>Who will be affected?</b></p>
      <p>Everyone using the specified endpoints to retrieve the labels of a deal.</p>
      <p>If you have any questions or comments, let us know in <a href="https://devcommunity.pipedrive.com/">the Developer’s Community</a>.</p>
    </div>
</div>
`}</HTMLBlock>

The data type of a deal’s label response field will be changed from integer to string to support the functionality of having multiple labels in one deal, which will be introduced in our web app.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 17, 2023</span>
    </div>
    <div class="change-area">
      <p>UPDATE: The implementation of this change has been delayed. We apologize for any confusion or inconvenience this may have caused. From <b>March 29, 2023</b>, we are starting the gradual rollout of this change. Please refer to the <a href="https://developers.pipedrive.com/changelog/post/update-to-the-breaking-change-in-codelabelcode-response-fields-data-type-for-deals">updated announcement in Changelog</a> for further details.</p>
      
      <p><b>What is changing?</b></p>
      <p>From <b>January 17, 2023</b>, the data type of a <b>deal’s</b> <code>label</code> response field will be changed from <code>integer</code> to <code>string</code>:</p>
      <ul>
        <li>If the deal has a single label specified, the label ID will be returned as a <code>string</code></li>
        <li>If the deal has multiple labels specified, the label IDs will be returned as a comma separated <code>string</code></li>
      </ul>
      
      <p>The change affects the following deals-related endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDeals">GET /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDeal">GET /deals/{id} </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDealsTimeline">GET /deals/timeline</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganizationDeals">GET /organizations/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#getPersonDeals">GET /persons/{id}/deals </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Pipelines#getPipelineDeals">GET /pipelines/{id}/deals </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProductDeals">GET /products/{id}/deals </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Stages#getStageDeals">GET /stages/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#addDeal">POST /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#duplicateDeal">POST /deals/{id}/duplicate</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#updateDeal">PUT /deals/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#mergeDeals">PUT /deals/{id}/merge</a></code></li>
      </ul>
      
      <p>For the <code><a href="https://developers.pipedrive.com/docs/api/v1/DealFields#getDealFields">GET /dealFields</a></code> and <code><a href="https://developers.pipedrive.com/docs/api/v1/DealFields#getDealField">GET /dealFields/{id}</a></code> endpoints, the <code>field_type</code> associated with the <code>“key”: “label”</code> response object will be <code>set</code>, instead of the current <code>enum</code> type.</p>
      
      <p><b>Why is it changing?</b></p>
      <p>We are changing the data type of a deal’s label response field from <code>integer</code> to <code>string</code> to support the functionality of having multiple labels in one deal, which will be introduced in our web app.</p>
      
      <p><b>Who will be affected?</b></p>
      <p>Everyone using the specified endpoints to retrieve the labels of a deal.</p>
      <p>If you have any questions or comments, let us know in <a href="https://devcommunity.pipedrive.com/">the Developer’s Community</a>.</p>
    </div>
</div>


Breaking change in <code>label</code> response field’s data type for Deals

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 4, 2023</span>
    </div>
    <div class="change-area">
      <p><b>What is changing?</b></p>
      <p>From <b>January 4, 2023</b>, we will be removing the <code>followers_count</code> response field from the following Products-related endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDealProducts">GET /deals/{id}/products</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProducts">GET /products</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProduct">GET /products/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#addProduct">POST /products</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#updateProduct">PUT /products/{id}</a></code></li>
      </ul>
      <p>Additionally, this field will be removed from the response payload of the <code>product</code> webhook.</p>
      
      <p><b>Why is it changing?</b></p>
      <p>We’re removing the response field because the Products API contains a specified endpoint for retrieving the followers of a product - <code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProductFollowers">GET /products/{id}/followers</a></code>. We recommend using this endpoint to get followers’ information in more detail.</p>
      
      <p><b>Who will be affected?</b></p>
      <p>Everyone using the 5 specified endpoints to find the number of followers for a product.</p>
      
      <p>If you have any questions or comments, let us know in <a href="https://devcommunity.pipedrive.com/">the Developer’s Community</a>.</p>
    </div>
</div>
`}</HTMLBlock>

The followers_count response field will be removed from Products-related endpoints and the product webhook.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">January 4, 2023</span>
    </div>
    <div class="change-area">
      <p><b>What is changing?</b></p>
      <p>From <b>January 4, 2023</b>, we will be removing the <code>followers_count</code> response field from the following Products-related endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDealProducts">GET /deals/{id}/products</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProducts">GET /products</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProduct">GET /products/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#addProduct">POST /products</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#updateProduct">PUT /products/{id}</a></code></li>
      </ul>
      <p>Additionally, this field will be removed from the response payload of the <code>product</code> webhook.</p>
      
      <p><b>Why is it changing?</b></p>
      <p>We’re removing the response field because the Products API contains a specified endpoint for retrieving the followers of a product - <code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProductFollowers">GET /products/{id}/followers</a></code>. We recommend using this endpoint to get followers’ information in more detail.</p>
      
      <p><b>Who will be affected?</b></p>
      <p>Everyone using the 5 specified endpoints to find the number of followers for a product.</p>
      
      <p>If you have any questions or comments, let us know in <a href="https://devcommunity.pipedrive.com/">the Developer’s Community</a>.</p>
    </div>
</div>


Removal of <code>followers_count</code> response field from Products endpoints and webhook

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">October 31, 2022</span>
    </div>
    <div class="change-area">
      
      <p>1. We have corrected the documentation of <code>Content-Type</code> for body parameters from <code>application/x-www-form-urlencoded</code> to <code>application/json</code> to reflect reality for the following ActivityTypes endpoints: </p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/ActivityTypes#addActivityType">POST /activityTypes</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/ActivityTypes#updateActivityType">PUT /activityTypes/{id}</a></code></li>
      </ul>
      
      <p>2. The <code>related_objects</code> section of the response example now includes <code>stage</code> and <code>pipeline</code> information to reflect reality for the following endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDeals">GET /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDeal">GET /deals/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganizationDeals">GET /organizations/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#getPersonDeals">GET /persons/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProductDeals">GET /products/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#addDeal">POST /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#updateDeal">PUT /deals/{id}</a></code></li>
      </ul>
      
    </div>
</div>
`}</HTMLBlock>

The latest improvements to our API Reference include a Content-Type update for ActivityTypes endpoints and documented stage and pipeline information in the response examples of Deals-related endpoints.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">October 31, 2022</span>
    </div>
    <div class="change-area">
      
      <p>1. We have corrected the documentation of <code>Content-Type</code> for body parameters from <code>application/x-www-form-urlencoded</code> to <code>application/json</code> to reflect reality for the following ActivityTypes endpoints: </p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/ActivityTypes#addActivityType">POST /activityTypes</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/ActivityTypes#updateActivityType">PUT /activityTypes/{id}</a></code></li>
      </ul>
      
      <p>2. The <code>related_objects</code> section of the response example now includes <code>stage</code> and <code>pipeline</code> information to reflect reality for the following endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDeals">GET /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#getDeal">GET /deals/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganizationDeals">GET /organizations/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Persons#getPersonDeals">GET /persons/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Products#getProductDeals">GET /products/{id}/deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#addDeal">POST /deals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Deals#updateDeal">PUT /deals/{id}</a></code></li>
      </ul>
      
    </div>
</div>


October 2022 release notes

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 16, 2022</span>
    </div>
    <div class="change-area">
     
      <p><b>What is changing?</b></p>
      <p>From <b>December 16, 2022</b>, the <code>type.params.pipeline_id</code> 
        and <code>type.params.activity_type_id</code> query parameters will only 
        accept the specified IDs as an <b>array</b> for the 
        <code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#getGoals">GET /goals/find</a></code> endpoint.</p>
      
      <p>Similarly, the <code>pipeline_id</code> and <code>activity_type_id</code>
        response fields will be returned as an <b>array</b> in the following 
        endpoints’ responses:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#getGoals">GET /goals/find</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#getGoalResult">GET /goals/{id}/results</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#addGoal">POST /goals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#updateGoal">PUT /goals/{id}</a></code></li>
      </ul>
      
      <p><b>Why is it changing?</b></p>
      <p>Due to a legacy implementation on our side, the 
        <code>type.params.pipeline_id</code> and 
        <code>type.params.activity_type_id</code> query parameters have so far 
        accepted both integer and array data types. From December 16, 2022, 
        they will accept and return an array to support the inclusion of 
        multiple pipelines and/or activity types for your goals.</p>
      
      <p><b>Who will be affected?</b></p>
      <p>Everyone using the specified query parameters to find goals and/or strictly checking the response structure of these endpoints.</p>
      <p>If you have any questions or comments, let us know in <a href="https://devcommunity.pipedrive.com/">the Developer’s Community</a>.</p>
    
  </div>
</div>
`}</HTMLBlock>

The type.params.pipeline_id and type.params.activity_type_id query parameters will only accept the specified IDs as an array for the GET /goals/find endpoint. Additionally, these parameters will be returned as arrays in the responses of Goals API endpoints.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 16, 2022</span>
    </div>
    <div class="change-area">
     
      <p><b>What is changing?</b></p>
      <p>From <b>December 16, 2022</b>, the <code>type.params.pipeline_id</code> 
        and <code>type.params.activity_type_id</code> query parameters will only 
        accept the specified IDs as an <b>array</b> for the 
        <code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#getGoals">GET /goals/find</a></code> endpoint.</p>
      
      <p>Similarly, the <code>pipeline_id</code> and <code>activity_type_id</code>
        response fields will be returned as an <b>array</b> in the following 
        endpoints’ responses:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#getGoals">GET /goals/find</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#getGoalResult">GET /goals/{id}/results</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#addGoal">POST /goals</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#updateGoal">PUT /goals/{id}</a></code></li>
      </ul>
      
      <p><b>Why is it changing?</b></p>
      <p>Due to a legacy implementation on our side, the 
        <code>type.params.pipeline_id</code> and 
        <code>type.params.activity_type_id</code> query parameters have so far 
        accepted both integer and array data types. From December 16, 2022, 
        they will accept and return an array to support the inclusion of 
        multiple pipelines and/or activity types for your goals.</p>
      
      <p><b>Who will be affected?</b></p>
      <p>Everyone using the specified query parameters to find goals and/or strictly checking the response structure of these endpoints.</p>
      <p>If you have any questions or comments, let us know in <a href="https://devcommunity.pipedrive.com/">the Developer’s Community</a>.</p>
    
  </div>
</div>


Breaking change in Goals API <code>pipeline_id</code> and <code>activity_type_id</code> data types

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 5, 2022</span>
    </div>
    <div class="change-area">
     
      <p><b>What is changing?</b></p>
      <p>We have deprecated and will remove the <code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#getRoleSubRoles">GET /roles/{id}/roles</a></code> endpoint from the Roles API on <b>December 5, 2022</b>.</p>
      <p>We strongly advise you to avoid using the deprecated endpoint.</p>
      
      <p><b>Who will be affected?</b></p>
      <p>Everyone who is using the deprecated <code>GET</code> endpoint for retrieving the sub-roles of a role.</p>
      <p>If you have any questions or comments, let us know in <a href="https://devcommunity.pipedrive.com/">the Developer’s Community</a>.</p>
    
    
  </div>
</div>
`}</HTMLBlock>

We have deprecated and will remove the GET /roles/{id}/roles endpoint from the Roles API.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">December 5, 2022</span>
    </div>
    <div class="change-area">
     
      <p><b>What is changing?</b></p>
      <p>We have deprecated and will remove the <code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#getRoleSubRoles">GET /roles/{id}/roles</a></code> endpoint from the Roles API on <b>December 5, 2022</b>.</p>
      <p>We strongly advise you to avoid using the deprecated endpoint.</p>
      
      <p><b>Who will be affected?</b></p>
      <p>Everyone who is using the deprecated <code>GET</code> endpoint for retrieving the sub-roles of a role.</p>
      <p>If you have any questions or comments, let us know in <a href="https://devcommunity.pipedrive.com/">the Developer’s Community</a>.</p>
    
    
  </div>
</div>


Removal of the <code>GET /roles/{id}/roles</code> endpoint

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">September 29, 2022</span>
    </div>
    <div class="change-area">
     
      <p>1. We have corrected the documentation of Content-Type for body parameters from <code>application/x-www-form-urlencoded</code> to <code>application/json</code> to reflect reality for the following Goals, Roles and Users API endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#updateGoal">PUT /goals/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#addRole">POST /roles</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#addRoleAssignment">POST /roles/{id}/assignments </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#addOrUpdateRoleSetting">POST /roles/{id}/settings</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#updateRole">PUT /roles/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#deleteRoleAssignment">DELETE /roles/{id}/assignments</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#updateUser">PUT /users/{id}</a></code></li>
      </ul>
      
      <p>2. The <code>name</code> body parameter was labeled as <code>required</code> to reflect reality for the <code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#addRole">POST /roles</a></code> endpoint.</p>
    
  </div>
</div>
`}</HTMLBlock>

The latest changes to our API Reference include: updated Content-Type for Goals, Roles and Users API body parameters and removed the required label from POST /roles name parameter.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">September 29, 2022</span>
    </div>
    <div class="change-area">
     
      <p>1. We have corrected the documentation of Content-Type for body parameters from <code>application/x-www-form-urlencoded</code> to <code>application/json</code> to reflect reality for the following Goals, Roles and Users API endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Goals#updateGoal">PUT /goals/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#addRole">POST /roles</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#addRoleAssignment">POST /roles/{id}/assignments </a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#addOrUpdateRoleSetting">POST /roles/{id}/settings</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#updateRole">PUT /roles/{id}</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#deleteRoleAssignment">DELETE /roles/{id}/assignments</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#updateUser">PUT /users/{id}</a></code></li>
      </ul>
      
      <p>2. The <code>name</code> body parameter was labeled as <code>required</code> to reflect reality for the <code><a href="https://developers.pipedrive.com/docs/api/v1/Roles#addRole">POST /roles</a></code> endpoint.</p>
    
  </div>
</div>


September 2022 release notes

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">November 4, 2022</span>
    </div>
    <div class="change-area">
      
      <p><b>What is changing?</b></p> 
      <p>All values of the <code>date</code> type inside a filter’s conditions have to adhere to the <code>YYYY-MM-DD</code> date format.</p>
      <p>This update applies to the following Filters API endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Filters#addFilter">POST /filters</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Filters#updateFilter">PUT /filters/{id}</a></code></li>
      </ul>
      
      <p>If an invalid <code>date</code> format is included in the condition(s), the request will return a <code>400</code> error response.</p>
      
      <p>Here’s an example for filtering deals by their expected close date:</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-property">"name"</span>: <span class="cm-string">"Filter by expected close date"</span>,
    <span class="cm-property">"type"</span>: <span class="cm-string">"deals"</span>,
    <span class="cm-property">"conditions"</span>: {
        <span class="cm-property">"glue"</span>: <span class="cm-string">"and"</span>,
        <span class="cm-property">"conditions"</span>: [{
            <span class="cm-property">"glue"</span>: <span class="cm-string">"and"</span>,
            <span class="cm-property">"conditions"</span>: [{
                <span class="cm-property">"object"</span>: <span class="cm-string">"deal"</span>,
                <span class="cm-property">"field_id"</span>: <span class="cm-string">"12345"</span>,
                <span class="cm-property">"operator"</span>: <span class="cm-string">"&lt;="</span>,
                <span class="cm-property">"value"</span>: <span class="cm-string">"2022-09-05"</span>,
                <span class="cm-property">"extra_value"</span>: <span class="cm-atom">null</span>
            }]
        }, {
            <span class="cm-property">"glue"</span>: <span class="cm-string">"or"</span>,
            <span class="cm-property">"conditions"</span>: []
        }]
    }
}
</div></code></pre></div></div>
      
     
      <p><b>Why is it changing?</b></p> 
      <p>The <code>YYYY-MM-DD</code> date format will be applied to make sure 
        that the Filters API is consistent with the Pipedrive web app. 
        This ensures that the filters you create with date conditions work 
        as expected and return the correct results.</p>
      
      <p><b>Who will be affected?</b></p> 
      <p>Everyone who is using the <code>POST</code> and <code>PUT</code> endpoints 
        for adding filters.</p>
      
      <p>If you have any questions or comments, let us know in 
        the <a href="https://devcommunity.pipedrive.com/">Developer’s Community</a>.</p>
     
   </div>
</div>
`}</HTMLBlock>

All date type values inside a filter’s conditions will have to adhere to the YYYY-MM-DD date format. The update will apply to the POST /filters and PUT /filters/{id} endpoints.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">November 4, 2022</span>
    </div>
    <div class="change-area">
      
      <p><b>What is changing?</b></p> 
      <p>All values of the <code>date</code> type inside a filter’s conditions have to adhere to the <code>YYYY-MM-DD</code> date format.</p>
      <p>This update applies to the following Filters API endpoints:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Filters#addFilter">POST /filters</a></code></li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Filters#updateFilter">PUT /filters/{id}</a></code></li>
      </ul>
      
      <p>If an invalid <code>date</code> format is included in the condition(s), the request will return a <code>400</code> error response.</p>
      
      <p>Here’s an example for filtering deals by their expected close date:</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-property">"name"</span>: <span class="cm-string">"Filter by expected close date"</span>,
    <span class="cm-property">"type"</span>: <span class="cm-string">"deals"</span>,
    <span class="cm-property">"conditions"</span>: {
        <span class="cm-property">"glue"</span>: <span class="cm-string">"and"</span>,
        <span class="cm-property">"conditions"</span>: [{
            <span class="cm-property">"glue"</span>: <span class="cm-string">"and"</span>,
            <span class="cm-property">"conditions"</span>: [{
                <span class="cm-property">"object"</span>: <span class="cm-string">"deal"</span>,
                <span class="cm-property">"field_id"</span>: <span class="cm-string">"12345"</span>,
                <span class="cm-property">"operator"</span>: <span class="cm-string">"&lt;="</span>,
                <span class="cm-property">"value"</span>: <span class="cm-string">"2022-09-05"</span>,
                <span class="cm-property">"extra_value"</span>: <span class="cm-atom">null</span>
            }]
        }, {
            <span class="cm-property">"glue"</span>: <span class="cm-string">"or"</span>,
            <span class="cm-property">"conditions"</span>: []
        }]
    }
}
</div></code></pre></div></div>
      
     
      <p><b>Why is it changing?</b></p> 
      <p>The <code>YYYY-MM-DD</code> date format will be applied to make sure 
        that the Filters API is consistent with the Pipedrive web app. 
        This ensures that the filters you create with date conditions work 
        as expected and return the correct results.</p>
      
      <p><b>Who will be affected?</b></p> 
      <p>Everyone who is using the <code>POST</code> and <code>PUT</code> endpoints 
        for adding filters.</p>
      
      <p>If you have any questions or comments, let us know in 
        the <a href="https://devcommunity.pipedrive.com/">Developer’s Community</a>.</p>
     
   </div>
</div>


Breaking change in Filters API <code>date</code> value

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">August 31, 2022</span>
    </div>
    <div class="change-area">
     
      <p>1. The <code>required</code> label has been removed from the body parameters of the following endpoints to reflect reality:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#addUser">POST /users</a></code>: <code>active_flag</code> is not required</li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Organizations#updateOrganization">PUT /organizations/{id}</a></code>: <code>name</code> is not required</li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Notes#updateNote">PUT /notes/{id}</a></code>: <code>content</code> is not required</li>
      </ul>
      
      <p>2. Apps can now access the <code><a href="https://developers.pipedrive.com/docs/api/v1/Filters#getFilterHelpers">GET /filters/helpers</a></code> endpoint with the following <a href="https://pipedrive.readme.io/docs/marketplace-scopes-and-permissions-explanations">OAuth scopes</a>:</p>
      <ul>
        <li><code>deals:read</code></li>
        <li><code>deals:full</code></li>
        <li><code>activities:read</code></li>
        <li><code>activities:full</code></li>
        <li><code>contacts:read</code></li>
        <li><code>contacts:full</code></li>
      </ul>
     
  </div>
</div>
`}</HTMLBlock>

The latest update to our developer platform includes additional OAuth scopes for the GET /filters/helpers endpoint.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">August 31, 2022</span>
    </div>
    <div class="change-area">
     
      <p>1. The <code>required</code> label has been removed from the body parameters of the following endpoints to reflect reality:</p>
      <ul>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Users#addUser">POST /users</a></code>: <code>active_flag</code> is not required</li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Organizations#updateOrganization">PUT /organizations/{id}</a></code>: <code>name</code> is not required</li>
        <li><code><a href="https://developers.pipedrive.com/docs/api/v1/Notes#updateNote">PUT /notes/{id}</a></code>: <code>content</code> is not required</li>
      </ul>
      
      <p>2. Apps can now access the <code><a href="https://developers.pipedrive.com/docs/api/v1/Filters#getFilterHelpers">GET /filters/helpers</a></code> endpoint with the following <a href="https://pipedrive.readme.io/docs/marketplace-scopes-and-permissions-explanations">OAuth scopes</a>:</p>
      <ul>
        <li><code>deals:read</code></li>
        <li><code>deals:full</code></li>
        <li><code>activities:read</code></li>
        <li><code>activities:full</code></li>
        <li><code>contacts:read</code></li>
        <li><code>contacts:full</code></li>
      </ul>
     
  </div>
</div>


August 2022 release notes

<HTMLBlock>{`
<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">August 10, 2022</span>
    </div>
    <div class="change-area">
      
      <p><b>What is being added?</b></p>
      <p><a href="https://jwt.io/">JSON web token</a> (JWT) capability has been added to <a href="https://pipedrive.readme.io/docs/app-extensions-actions">Link actions</a> (formerly basic app actions) and <a href="https://pipedrive.readme.io/docs/app-extensions-json-panels">JSON panels</a> (formerly app panels) app extensions.</p>
      <p>For JSON panels, you now have a choice to use either <a href="https://pipedrive.readme.io/docs/json-panels-adding-a-panel#how-can-i-add-a-json-panel-in-marketplace-manager">Basic Authentication</a> or JWT. It is also possible to configure both.</p>  
    
      <p><b>Why is it being added?</b></p>
      <p>JWT adds a layer of security and more flexibility on top of Link actions initiated from Pipedrive and requests sent from a JSON panel to a 3rd party server. It also provides a more versatile authentication option for JSON panel requests.</p>
      <p>This addition means JWT is now available uniformly across all our app extension requests.</p>

      <p><b>Who is affected?</b></p>
      <p>Anyone who is building an app or has an app that uses Link actions and JSON panels app extensions.</p>
   
  </div>
</div>
`}</HTMLBlock>

JSON web token (JWT) capability has now been added to Link actions and JSON panels app extensions.


<div class="chlog-box">
    <div class="from-area">
        <span class="from-label">Effective from:</span><br>
        <span class="from-date">August 10, 2022</span>
    </div>
    <div class="change-area">
      
      <p><b>What is being added?</b></p>
      <p><a href="https://jwt.io/">JSON web token</a> (JWT) capability has been added to <a href="https://pipedrive.readme.io/docs/app-extensions-actions">Link actions</a> (formerly basic app actions) and <a href="https://pipedrive.readme.io/docs/app-extensions-json-panels">JSON panels</a> (formerly app panels) app extensions.</p>
      <p>For JSON panels, you now have a choice to use either <a href="https://pipedrive.readme.io/docs/json-panels-adding-a-panel#how-can-i-add-a-json-panel-in-marketplace-manager">Basic Authentication</a> or JWT. It is also possible to configure both.</p>  
    
      <p><b>Why is it being added?</b></p>
      <p>JWT adds a layer of security and more flexibility on top of Link actions initiated from Pipedrive and requests sent from a JSON panel to a 3rd party server. It also provides a more versatile authentication option for JSON panel requests.</p>
      <p>This addition means JWT is now available uniformly across all our app extension requests.</p>

      <p><b>Who is affected?</b></p>
      <p>Anyone who is building an app or has an app that uses Link actions and JSON panels app extensions.</p>
   
  </div>
</div>


Contents

Changelog

Announced changes

Subscribe to our Changelog

Subscribe to our Changelog

Subscribe to our
Changelog