API 2.0 Sneak Preview and your thoughts on our new Partner Program 👀

Hey everyone :wave:t3:

We’re excited to announce brand-new features that will help you activate and retain more customers on your Intercom app. You can now add a Start Guide to your app listing to make it easy for new users to get up and running, and implement a Health Check to help users resolve installation issues more quickly. Plus, we’re eager to hear your feedback on the new APIs currently in beta and the partner program we’re developing. Read on for more details!

Sneak preview: A powerful, new-and-improved API :gem:

We’re excited to share that we’ll be releasing a major update to our API in the new year: version 2.0! The new version will include:

  • A new, strictly RESTful Contacts API that combines users and leads — collectively known as “contacts” — and enables you to retrieve the exact contacts you need by filtering using any combination of fields, like location or NPS score. Plus, the API exposes new attributes, like “last contacted” and “browser version,” and uses cursor-based pagination to give you access to all of your contacts without restrictions.
  • An updated Conversations API that enables you to tag conversations directly, search and retrieve conversations by any combination of fields, and access more granular timestamps and out-of-the-box metrics, like “time to first response” and “median time to reply.”
  • A new Data Attributes API that lets you create and update custom data attributes, set a label and description for each, and build a dropdown list of defined attribute options. This means your app users can more easily leverage data when targeting and communicating with customers and leads.

We’ve released the Contacts and Data Attributes APIs — as well as the conversation tagging endpoint — so you can get early access in our Unstable API version. Try them out and feel free to share any feedback you have with us.

Help us shape our future partner program :newspaper_roll:

We’re developing a partner program to help you become more successful in the Intercom App Store and get more value from your partnership with Intercom :raised_hands: We’d love to get your input so that we can build a program with benefits that are the most impactful for you. Please take a few minutes to fill out this survey by December 20!

Thanks so much for reading - until next time, let us know all feedback and thoughts you have. We love to hear from you :heart:


Contacts API is really cool!
One odd behaviour I’ve noticed is that you can’t search multiple contacts (IN) by their id, it seems like an underscore is added before the field name resulting with the following error:

“errors”:[{“code”:“invalid_field”,“message”:"_id is not a valid search field"}]

POST https://api.intercom.io/contacts/search
Content-Type: application/json
Accept: application/json
Authorization: Bearer
Content-Length: 195

{“query”: {“operator”: “IN”, “field”: “id”, “value”: []}}