Skip to main content

I would like to use from REST API features such as queries for searching conversations however our API version is 1.0 and so we'd need to upgrade it. 

 

I am wondering whether changing the API version will cause any breaking changes in the intercom app.

 

FYR this is what I'm talking about: https://developers.intercom.com/intercom-api-reference/v1.0/reference#get-a-single-conversation & https://developers.intercom.com/intercom-api-reference/reference#search-for-conversations

As you can see, V2.3 allows queries in searching for conversation where we'll search by the user id

 

 

👋 Hello @user957​ , Welcome to Interconnect ✨

 

Yes, that will affect to Intercom app as well, let me explain. Once you are moving from V1 to V2 there significant changes made like:

Users, Leads, Visitors become contacts in V2;

 

So if you just update from V1 to V2 there will be lot's of problems =/ 

 

The much faster way in your case will be to select the version via the API request, so for some requests, you can use V2.3 until you move the whole product to the new API version.

 

More information about selecting API version per request can be found here.


It is also possible to use a different per request basis. This can be done using the Intercom-Version header.


Got it! Thank you!


Got it! Thank you!


Reply