[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">April 15, 2020</span>\n    </div>\n <div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"new-paramteres-added-activities-post-and-put-endpoints\"></div>\n        <div class=\"heading-text\"><div id=\"new-paramteres-added-activities-post-and-put-endpoints\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>New parameters added to <code>/activities</code> <code>POST</code> and <code>PUT</code> endpoints</div>\n        <a aria-label=\"Skip link to New parameters added to /activities POST and PUT endpoints\" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#new-paramteres-added-activities-post-and-put-endpoints\"></a></h3>\n\n      <p>We have added four new parameters to <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Activities#addActivity\" target=\"_self\">POST /activities</a></code> and <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Activities#updateActivity\" target=\"_self\">PUT /activities/{id}</a></code> endpoints:</p>\n   <div class=\"rdmd-table\"><div class=\"rdmd-table-inner\"><table><thead><tr><th style=\"text-align:left\">Parameter</th><th style=\"text-align:left\">Description</th></tr></thead><tbody><tr><td style=\"text-align:left\"><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\"><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><span class=\"cm-s-neo\">location</span></code></td><td style=\"text-align:left\">Allows inserting the address of the activity.</td></tr><tr><td style=\"text-align:left\"><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\"><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><span class=\"cm-s-neo\">public_description</span></code></td><td style=\"text-align:left\">Allows adding additional details about the activity that will be synced to your external calendar.</td></tr><tr><td style=\"text-align:left\"><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\"><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><span class=\"cm-s-neo\">busy_flag</span></code></td><td style=\"text-align:left\">Allows setting the activity as “busy” or “free”.</td></tr><tr><td style=\"text-align:left\"><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\"><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><span class=\"cm-s-neo\">attendees</span></code></td><td style=\"text-align:left\">Allows adding guests to the activity whether it is an existing Pipedrive contact or an external email address.</td></tr></tbody></table></div></div>\n \n        <p class=\"published-on\"><i>Published on April 15, 2020</i></p>\n    </div>\n</div>"
}
[/block]

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

New parameters added to <code>/activities POST</code> and <code>PUT</code> endpoints

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">March 31, 2021</span>\n    </div>\n   <div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"removal-of-the-/find-/searchresults-and-/searchresults/field-endpoints-replaced-by-6-new-endpoints\"></div>\n        <div class=\"heading-text\"><div id=\"removal-of-the-/find-/searchresults-and-/searchresults/field-endpoints-replaced-by-6-new-endpoints\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>Removal of the <code>/*/find</code>, <code>/searchResults</code>, and <code>/searchResults/field</code> endpoints, replaced by 6 new endpoints</div>\n        <a aria-label=\"Skip link to Removal of the /*/find, /searchResults, and /searchResults/field endpoints, replaced by 6 new endpoints\" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#removal-of-the-/find-/searchresults-and-/searchresults/field-endpoints-replaced-by-6-new-endpoints\"></a></h3>\n \n  \n       <p><b>What will change?</b></p>\n       <p>We have now deprecated and will soon be removing the following 6 API endpoints: </p>\n   <ul>\n<li><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#getDealsByName\" target=\"_self\">GET /deals/find</a> - Searches all deals by their title</li>\n        <li><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#findPersonByName\" target=\"_self\">GET /persons/find</a> - Searches all persons by their name</li>\n        <li><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganizationByName\" target=\"_self\">GET /organizations/find</a> - Searches all organizations by their name</li>\n        <li><a href=\"https://developers.pipedrive.com/docs/api/v1/Products#findProductsByName\" target=\"_self\">GET /products/find</a> - Returns data about the products that were found.</li>\n        <li><a href=\"https://developers.pipedrive.com/docs/api/v1/SearchResults#search\" target=\"_self\">GET /searchResults</a> - Searches all items or 1 item by all fields</li>\n        <li><a href=\"https://developers.pipedrive.com/docs/api/v1/SearchResults#searchByField\" target=\"_self\">GET /searchResults/field</a> - searches 1 item type by 1 field</li></ul>\n\n<p>We strongly advise you to avoid the use of these 6 <b>deprecated</b> API endpoints.</p>\n\n\n      \n     <p><b> Why?</b></p>\n<p>We are introducing 6 new endpoints:</p>\n      \n <ul>\n<li><a href=\"https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItem\" target=\"_self\">GET /itemSearch</a></li>\n       <li><a href=\"https://developers.pipedrive.com/docs/api/v1/ItemSearch#searchItemByField\" target=\"_self\">GET /itemSearch/field</a></li>\n       <li><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#searchDeals\" target=\"_self\">GET /deals/search</a> </li>\n       <li><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#searchPersons\" target=\"_self\">GET /persons/search</a> </li>\n       <li><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#searchOrganization\" target=\"_self\">GET /organizations/search</a> </li>\n       <li><a href=\"https://developers.pipedrive.com/docs/api/v1/Products#searchProducts\" target=\"_self\">GET /products/search</a> </li>\n     </ul>\n\n\n     \n<p>The new Search API endpoints offer extended functionality over the old search API and have a unified future-proof response format. The extended functionality allows you to do complicated queries from several item types and fields at once. </p>\n      \n<p>For example you can use <code>/v1/itemSearch?item_types=deal,person&fields=title,name,custom_fields&term=example</code> to search from all persons and deals by the person’s name, deal title and both items custom fields and order them by relevance.</p>\n\n<p>The <code>/*/search</code> endpoints are aliases for <code>/v1/itemSearch?item_types=*</code> endpoint with narrower OAuth2 scopes for if you are a marketplace app owner and would like your app to only have <code>read</code> access to specific item types instead of the full search scope.</p>\n\n     <p><b> Who is affected?</b></p>\n      <p>Anyone depending on the previously listed 6 <b>deprecated</b> endpoints in any way is affected. In case you are using the previously listed 6 <b>deprecated</b> API endpoints in your code or 3rd party app/integration, please remove any dependency on these endpoints as soon as possible, or by <b>March 31, 2021</b> the latest. For additional help, check out <a href=\"/docs/new-search-api-migration-guide\">new search API migration guide</a>. </p>\n \n        <p class=\"published-on\"><i>Published on April 8, 2020</i></p>\n    </div>\n</div>"
}
[/block]

Removal of the <code>/*/find</code>, <code>/searchResults</code>, and <code>/searchResults/field</code> endpoints, replaced by 6 new endpoints

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">May 31, 2020</span>\n    </div>\n <div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"removal-of-the-reference-activities-count-field\"></div>\n        <div class=\"heading-text\"><div id=\"removal-of-the-reference-activities-count-field\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>Removal of the <code>reference_activities_count</code> field</div>\n        <a aria-label=\"Skip link to Removal of the reference_activities_count field\" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#removal-of-the-reference-activities-count-field\"></a></h3>\n\n      <p><b>What will change?</b></p>\n     <p> We have now deprecated and will be removing the <code>reference_activities_count</code> field on May 31, 2020 from\n      <ul><li>the responses of the following Deal, Person and Organization endpoints\n</li><li>the Deal, Person, and Organization <a href=\"https://pipedrive.readme.io/docs/list-of-webhooks\">related webhook</a> payloads</li> </ul>   </p>\n     <p> Here is the list of <b>21 affected endpoints</b>:</p>\n ><ul>\n<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#getDeals\" target=\"_self\">GET /deals</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#getDeal\" target=\"_self\">GET /deals/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#addDeal\" target=\"_self\">POST /deals</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#duplicateDeal\" target=\"_self\">POST /deals/{id}/duplicate</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#addDealParticipant\" target=\"_self\">POST /deals/{id}/participants</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#updateDeal\" target=\"_self\">PUT /deals/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#mergeDeals\" target=\"_self\">PUT /deals/{id}/merge</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#getDealParticipants\" target=\"_self\">GET /deals/{id}/participants</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#getDealPersons\" target=\"_self\">GET /deals/{id}/persons</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganizations\" target=\"_self\">GET /organizations</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganization\" target=\"_self\">GET /organizations/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganizationDeals\" target=\"_self\">GET /organizations/{id}/deals</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganizationPersons\" target=\"_self\">GET /organizations/{id}/persons</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#addOrganization\" target=\"_self\">POST /organizations</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#updateOrganization\" target=\"_self\">PUT /organizations/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#getPersons\" target=\"_self\">GET /persons</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#getPerson\" target=\"_self\">GET /persons/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#getPersonDeals\" target=\"_self\">GET /persons/{id}/deals</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#addPerson\" target=\"_self\">POST /persons</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#updatePerson\" target=\"_self\">PUT /persons/{id}</a></code></li>\n        <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#mergePersons\" target=\"_self\">PUT /persons/{id}/merge</a></code></li></ul>\n\n\n      \n     <p>There will be no changes to any request body.</p>\n      \n      <p><b>Why?</b></p>\n     <p> We are no longer updating that field. Until removal, the value of the field will always be <code>0</code>: </p>\n  <div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\"><button type=\"button\">JSON</button></div><div class=\"CodeTabs-inner\"><pre><code class=\"rdmd-code lang-json theme-light\" data-lang=\"json\" name=\"\"><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><div class=\"cm-s-neo\"><span class=\"cm-string\">\"reference_activities_count\"</span>: <span class=\"cm-number\">0</span>\n</div></code></pre></div></div>\n      \n      <p><b>Who is affected?</b></p>\n      <p>Anyone with functionality built on top of the previous behaviour, for example, anyone who is strictly checking the shape of the response of the 21 endpoints and related webhooks.</p>\n \n        <p class=\"published-on\"><i>Published on March 31, 2020</i></p>\n    </div>\n</div>"
}
[/block]

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

Removal of the <code>reference_activities_count</code> field

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\"><b>Effective from:</b></span><br>\n        <span class=\"from-date\"><b>March 26, 2020</b></span>\n    </div>\n<div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"new-parameters-added-to-flow-endpoints\"></div>\n        <div class=\"heading-text\"><div id=\"new-parameters-added-to-flow-endpoints\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>New parameters added to flow endpoints</div>\n        <a aria-label=\"Skip link to New parameters added to flow endpoints\" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#new-parameters-added-to-flow-endpoints\"></a></h3>\n\n        <p>We have added new parameters <code>all_changes</code> and <code>items</code> to the following endpoints:</p>\n<ul>\n         <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Deals#getDealUpdates\">GET /deals/{id}/flow</a></code></li>\n<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Organizations#getOrganizationUpdates\">GET /organizations/{id}/flow</a></code></li>\n<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/Persons#getPersonUpdates\">GET /persons/{id}/flow</a></code></li>\n</ul><br>\n<p>The <code>all_changes</code> parameter allows you to choose whether to show custom field updates or not. The <code>items</code> parameter is a comma-separated string for filtering out item-specific updates.</p>\n \n        <p class=\"published-on\"><i>Published on March 26, 2020</i></p>\n    </div>\n</div>"
}
[/block]

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

New parameters added to flow endpoints

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">March 24, 2020</span>\n    </div>\n  <div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"new-field-added-to-custom-field-POST-endpoints\"></div>\n        <div class=\"heading-text\"><div id=\"new-field-added-to-custom-field-POST-endpoints\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>New field added to custom field <code>POST</code> endpoints</div>\n        <a aria-label=\"Skip link to New field added to custom field POST endpoints\" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#new-field-added-to-custom-field-POST-endpoints\"></a></h3> \n  \n      <p>We have added a new <code>address</code> field to the following endpoints:</p>\n<ul>\n         <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/DealFields#addDealField\">POST /dealFields</a></code></li>\n<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/OrganizationFields#addOrganizationField\">POST /organizationFields</a></code></li>\n<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/PersonFields#addPersonField\">POST /personFields</a></code></li>\n<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/ProductFields#addProductField\">POST /productFields</a></code></li></ul><br>\n<p>The <code>address</code> field is used to store addresses. You can read more about the types of custom fields <a href=\"https://pipedrive.readme.io/docs/core-api-concepts-custom-fields#section-types-of-custom-fields\">here</a>.</p>\n \n        <p class=\"published-on\"><i>Published on March 24, 2020</i></p>\n    </div>\n</div>"
}
[/block]

New field added to custom field <code>POST</code> endpoints

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">March 4, 2020</span>\n    </div>\n    <div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"new-fields-in-Users-GET-/users/me-endpoint\"></div>\n        <div class=\"heading-text\"><div id=\"new-fields-in-Users-GET-/users/me-endpoint\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>New fields in Users <code>GET /users/me</code> endpoint</div>\n        <a aria-label=\"Skip link to New fields in Users GET /users/me endpoint\" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#new-fields-in-Users-GET-/users/me-endpoint\"></a></h3>\n      \n      <p>We have added two new fields to the <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Users#getCurrentUser\">GET /users/me</a></code> endpoint. When getting the current user data, the output now contains the following fields:  </p>\n       <ul>\n         <li><code>company_country</code></li><li><code>company_industry</code></li></ul><br>\n      \n      <p>You can now see how the output will look like in the <a href=\"https://pipedrive.readme.io/docs/marketplace-getting-user-data\">getting user data</a> page.</P>\n        <p class=\"published-on\"><i>Published on March 4, 2020</i></p>\n    </div>\n</div>"
}
[/block]

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

New fields in <code>Users GET /users/me</code> endpoint

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">June 1, 2020</span>\n    </div>\n    <div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"new-parameter-in-oauth-/oauth/token/-responses\"></div>\n        <div class=\"heading-text\"><div id=\"new-parameter-in-oauth-/oauth/token/-responses\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>New parameter in OAuth <code>/oauth/token</code> responses</div>\n        <a aria-label=\"Skip link to New parameter in OAuth /oauth/token responses\" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#new-parameter-in-oauth-/oauth/token/-responses\"></a></h3>\n      \n      \n      <p><b>What will change?</b></p>\n<p>We have added a new parameter <code>api_domain</code> to OAuth <code>/oauth/token</code> responses. </p>\n\n<p>For now, only the apps created <b>on</b> or <b>after February 20, 2020</b> will see a new parameter in the OAuth <code>/oauth/token</code> response.\n</p>\n      \n<p>\n<b>On June 1, 2020</b>, the code will <b>automatically</b> start sending the new parameter to <b>all requests</b>, i.e. apps created before February 20, 2020 will also start seeing the new parameter in the OAuth <code>/oauth/token</code> response. If you are strictly checking the shape of the response, please update your code to take the new parameter into account.\n</p>\n      \n      <p><b>Why?</b></p>\n      \n<p>Until now (and because we ask you to use <code>https://companydomain.pipedrive.com</code> domains for making API requests), in order to find out the <code>company_domain</code>, you had to get the OAuth tokens first, make a request to <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Users#getCurrentUser\">/users/me</a></code> endpoint and store it on your side. Also, the <code>company_domain</code> can change so you had to make additional request to <code><a href=\"https://developers.pipedrive.com/docs/api/v1/Users#getCurrentUser\">/users/me</a></code> every once in a while.</p>\n      \n  <p>But with this change you do not have to do that anymore, because you will now receive up-to-date <code>company_domain</code> every time you make the initial request to get the tokens or when you refresh a token.</p>\n      \n      <p>The current response:</p>\n      \n     <div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\"><button type=\"button\">JSON</button></div><div class=\"CodeTabs-inner\"><pre><code class=\"rdmd-code lang-json theme-light\" data-lang=\"json\" name=\"\"><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><div class=\"cm-s-neo\">{\n    <span class=\"cm-property\">\"access_token\"</span>: <span class=\"cm-string\">\"53:179:6317ef33a9fb0c4d604ce0695dad44a12bad44c9\"</span>,\n    <span class=\"cm-property\">\"token_type\"</span>: <span class=\"cm-string\">\"Bearer\"</span>,\n    <span class=\"cm-property\">\"expires_in\"</span>: <span class=\"cm-number\">3599</span>,\n    <span class=\"cm-property\">\"refresh_token\"</span>: <span class=\"cm-string\">\"53:179:5de81994d77491d22bc10eab3bc0810f84864297\"</span>,\n    <span class=\"cm-property\">\"scope\"</span>: <span class=\"cm-string\">\"base,deals:full,contacts:read\"</span>\n}\n</div></code></pre></div></div>\n      \n      <p>The new response with the added <code>api_domain</code> parameter:</p>\n      \n    <div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\"><button type=\"button\">JSON</button></div><div class=\"CodeTabs-inner\"><pre><code class=\"rdmd-code lang-json theme-light\" data-lang=\"json\" name=\"\"><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><div class=\"cm-s-neo\">{\n    <span class=\"cm-property\">\"access_token\"</span>: <span class=\"cm-string\">\"53:179:6317ef33a9fb0c4d604ce0695dad44a12bad44c9\"</span>,\n    <span class=\"cm-property\">\"token_type\"</span>: <span class=\"cm-string\">\"Bearer\"</span>,\n    <span class=\"cm-property\">\"expires_in\"</span>: <span class=\"cm-number\">3599</span>,\n    <span class=\"cm-property\">\"refresh_token\"</span>: <span class=\"cm-string\">\"53:179:5de81994d77491d22bc10eab3bc0810f84864297\"</span>,\n    <span class=\"cm-property\">\"scope\"</span>: <span class=\"cm-string\">\"base,deals:full,contacts:read\"</span>,\n    <span class=\"cm-property\">\"api_domain\"</span>: <span class=\"cm-string\">\"https://mycompanydomain.pipedrive.com\"</span>\n}\n</div></code></pre></div></div>\n\n      <p><b>Who is affected?</b></p>\n <p>Any app created before February 20, 2020 with functionality built on top of the previous behavior need to <b>alter their code by June 1, 2020</b>.</p>\n      <p>Any apps created on or after February 20, 2020 will already see the new parameter in the OAuth <code>/oauth/token/</code> response and do not need to alter anything concerning this change.</p>\n      \n       <p class=\"published-on\"><i>Published on February 21, 2020</i></p>\n    </div>\n</div>"
}
[/block]

{"product": ["Authentication"], "features": ["OAuth"]}

New parameter in OAuth <code>/oauth/token</code> responses

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">December 10, 2019</span>\n    </div>\n    <div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"new-teams-resource\"></div>\n        <div class=\"heading-text\"><div id=\"new-teams-resource\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>New Teams resource</div>\n        <a aria-label=\"Skip link to New Teams resource\" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#new-teams-resource\"></a></h3>\n\n       \n      <p> We have added a brand new <code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Teams\" target=\"_self\">Teams</a></code> resource. Teams allow sales people to form groups of users within the organization for more efficient management.</p>\n<p>The new <code>Teams</code> resource includes the following endpoints:</p>\n<ul>\n<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Teams/get_teams\" target=\"_self\">GET /teams</a></code></li>\n  <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Teams/get_teams_id\" target=\"_self\">GET /teams/{id}</a></code></li>\n  <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Teams/get_teams_id_users\" target=\"_self\">GET /teams/{id}/users</a></code></li>\n  <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Teams/get_teams_user_id\" target=\"_self\">GET /teams/user/{id}</a></code></li>\n  <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Teams/post_teams\" target=\"_self\">POST /teams</a></code></li>\n   <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Teams/post_teams_id_users\" target=\"_self\">POST /teams/{id}/users</a></code></li>\n   <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Teams/put_teams_id\" target=\"_self\">PUT /teams/{id}</a></code></li>\n    <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Teams/delete_teams_id_users\" target=\"_self\">DELETE /teams/{id}/users</a></code></li>\n  </ul>\n\n       <p class=\"published-on\"><i>Published on December 10, 2019</i></p>\n    </div>\n</div>"
}
[/block]

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

New Teams resource

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\"><b>Effective from:</b></span><br>\n        <span class=\"from-date\"><b>November 29, 2019</b></span>\n    </div>\n    <div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"new-goals-resource\"></div>\n        <div class=\"heading-text\"><div id=\"new-goals-resource\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>New Goals resource</div>\n        <a aria-label=\"Skip link to Improved protection of user data \" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#new-goals-resource\"></a></h3>\n\n        \n      <p> We have added a brand new <code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Goals\" target=\"_self\">Goals</a></code> resource. Goals help sales teams meet their sales targets.</p>\n<p>The new <code>Goals</code> resource includes the following endpoints:</p>\n<ul>\n<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Goals/get_goals_find\" target=\"_self\">GET /goals/find</a></code></li>\n  <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Goals/get_goals_id_results\" target=\"_self\">GET /goals/{id}/results</a></code></li>\n  <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Goals/post_goals\" target=\"_self\">POST /goals</a></code></li>\n  <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Goals/put_goals_id\" target=\"_self\">PUT /goals/{id}</a></code></li>\n  <li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Goals/delete_goals_id\" target=\"_self\">DELETE /goals/{id}</a></code></li></ul>\n\n      \n       <p class=\"published-on\"><i>Published on November 29, 2019</i></p>\n    </div>\n</div>"
}
[/block]

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

New Goals resource

[block:html]
{
  "html": "<div class=\"chlog-box\">\n    <div class=\"from-area\">\n        <span class=\"from-label\">Effective from:</span><br>\n        <span class=\"from-date\">October 17, 2019</span>\n    </div>\n    \n   <div class=\"change-area\">\n      <h3 class=\"heading heading-3 header-scroll\" align=\"\">\n      <div class=\"heading-anchor anchor waypoint\" id=\"new-parameter-in-notes-post-and-put-endpoints\"></div>\n        <div class=\"heading-text\"><div id=\"new-parameter-in-notes-post-and-put-endpoints\" class=\"heading-anchor_backwardsCompatibility\">\n          </div>New parameter in Notes <code>POST</code> and <code>PUT</code> endpoints</div>\n        <a aria-label=\"Skip link to New parameter in Notes POST and PUT endpoints \" class=\"heading-anchor-icon fa fa-anchor\" \n           href=\"#new-parameter-in-notes-post-and-put-endpoints\"></a></h3>\n\n         \n      <p> We have added a new parameter <code>user_id</code> to the <code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Notes/post_notes\">POST /notes</a></code> and <code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Notes/put_notes_id\">PUT /notes/{id}</a></code> endpoints.\n</p>\n      <p>By inserting the ID of a user into the <code>user_id</code> parameter when making requests against the following endpoints, you can now choose or change the author of a note:  </p>\n      \n      <ul>\n<li><code><a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Notes/post_notes\">POST /notes</a></code></li><li><code> <a href=\"https://developers.pipedrive.com/docs/api/v1/#!/Notes/put_notes_id\">PUT /notes/{id}</a></code></li></ul><br>\n      \n      \n      <p>For example, this <code>user_id</code> parameter might come in handy when importing data to Pipedrive. Please keep in mind that only an <b>admin</b> can change the author. </p>\n      \n       <p class=\"published-on\"><i>Published on October 17, 2019</i></p>\n    </div>\n</div>"
}
[/block]

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

Contents

Changelog

Announced changes

Subscribe to our Changelog

Subscribe to our Changelog

Subscribe to our
Changelog