{"id":5795,"date":"2014-06-17T09:23:07","date_gmt":"2014-06-17T09:23:07","guid":{"rendered":"http:\/\/insideintercom.io\/?p=5795"},"modified":"2020-07-30T13:03:55","modified_gmt":"2020-07-30T12:03:55","slug":"new-intercom-api","status":"publish","type":"post","link":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/","title":{"rendered":"Automate and integrate with Intercom\u2019s new APIs"},"content":{"rendered":"

Today we\u2019re announcing the new Intercom APIs<\/a>, which are an important step in creating a great platform for developers to integrate Intercom with other products.<\/p>\n

At Intercom, our mission is to make internet business personal. We believe user- and conversation-focused APIs will provide the foundation for integrated applications across a range of platforms and products, and enable the creation of connected, personalized experiences.<\/p>\n

Our first API was introduced last year and helped thousands of customers integrate their data into Intercom. The new APIs will enable you to do even more and we’re excited to see what you will come up with!<\/p>\n

They provide many additional features that will allow you to send richer data about your users and companies, track the events they perform in your product, and send in-app and email messages to your users. We\u2019ve also added the ability to get counts of users, companies and conversations.<\/p>\n

Here are a few of the things you\u2019ll be able to do with the new APIs:<\/p>\n

Conversations<\/a><\/h2>\n

One of the most frequent requests we receive from our customers is to be able to send messages to users via the API, and today we\u2019re releasing that feature. The Conversations API<\/a> will allow you to send both email and in-app manual messages to your users. Using the API to start conversations with your users will allow you to use Intercom\u2019s innovative in-app messaging system in new and exciting ways directly from your product. You can also send replies to your users and extract the conversations you have with them.<\/p>\n

Counts<\/a><\/h2>\n

For the first time, we have built an API to expose summary counts of user, company and conversation data. The Counts API<\/a> gives you a birds eye view of how many users and companies meet the criteria set by tags and segments. These capabilities open up very exciting possibilities for monitoring and graphing data. Another significant feature is the ability to get a count of open and closed conversations per admin at any time, giving deeper insight into how your team is handling communication with your users.<\/p>\n

Companies<\/a><\/h2>\n

We have introduced the ability to manage companies with our new Companies API<\/a>. This new API is just one of the ways we are giving our B2B customers enhanced functionality around the companies they are dealing with. Much of this functionality was available with users, but these improvements will allow you to get a better view of what is happening with companies too. You will now be able to create and update company information, add custom attributes, and add or remove users from companies. We\u2019ve also added the ability to get lists of companies by tag and segment, and get the details of all the users in a company.<\/p>\n

Users<\/a><\/h2>\n

We have added more functionality to the Users API<\/a> to allow better management of user data. You can now get all standard and custom attributes about your users, along with social profiles, location data, and tag and segment information. We\u2019ve also added the ability to get lists of users by tag, segment, and company.<\/p>\n

Events<\/a><\/h2>\n

The Events API<\/a> was the first of our new APIs launched in April<\/a>, and has been key to helping our customers send more relevant and contextual messages to their users. Tracking events allows you to combine the live insight Intercom gives you into who your users are, with the knowledge of what they are doing in your product. Our analysis has found that customers who send Auto Messages triggered by events have increased their engagement rates by over 200%.<\/p>\n

While the current API will continue to be available, we encourage you to use this latest version to take advantage of the new features. To learn more, visit the Intercom Developer site<\/a>.<\/p>\n

We\u2019re just getting started<\/h3>\n

This step signals our serious commitment to allowing Intercom to work well with the other services you use and develop. We\u2019ve created an entire Platform team, who\u2019ve worked extremely hard on this release; thanks Bill<\/a> (Principal Engineer), Bob<\/a> (Engineer), and Jamie<\/a> (Engineer)\u2014and we\u2019re excited to get your feedback on this version, and your requests for future API functionality.<\/p>\n","protected":false},"excerpt":{"rendered":"

Today we\u2019re announcing the new Intercom APIs, which are an important step in creating a great platform for developers to integrate Intercom with other products. At Intercom, our mission is to make internet business personal. We…<\/p>\n","protected":false},"author":94,"featured_media":5798,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"category":[4],"tags":[242,195,143,194],"coauthors":[445],"class_list":["post-5795","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-news","tag-apis","tag-integrations","tag-intercom","tag-platform"],"yoast_head":"\nAutomate and Integrate with Intercom's new APIs<\/title>\n<meta name=\"description\" content=\"Today we\u2019re announcing the new Intercom APIs, an important step in creating a great platform for developers to integrate Intercom with other products.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.intercom.com\/blog\/new-intercom-api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Automate and integrate with Intercom\u2019s new APIs\" \/>\n<meta property=\"og:description\" content=\"Today we\u2019re announcing the new Intercom APIs, an important step in creating a great platform for developers to integrate Intercom with other products.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.intercom.com\/blog\/new-intercom-api\/\" \/>\n<meta property=\"og:site_name\" content=\"The Intercom Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/intercominc\" \/>\n<meta property=\"article:published_time\" content=\"2014-06-17T09:23:07+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2020-07-30T12:03:55+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.intercom.com\/blog\/wp-content\/uploads\/2014\/06\/API_Blog_370.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"370\" \/>\n\t<meta property=\"og:image:height\" content=\"230\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Michelle Fitzpatrick\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@shelliefitz\" \/>\n<meta name=\"twitter:site\" content=\"@intercom\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Michelle Fitzpatrick\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/\"},\"author\":{\"name\":\"Michelle Fitzpatrick\",\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/#\\\/schema\\\/person\\\/96e6d6cf68c7ecb85779703ff3c68311\"},\"headline\":\"Automate and integrate with Intercom\u2019s new APIs\",\"datePublished\":\"2014-06-17T09:23:07+00:00\",\"dateModified\":\"2020-07-30T12:03:55+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/\"},\"wordCount\":704,\"publisher\":{\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/wp-content\\\/uploads\\\/2014\\\/06\\\/API_Blog_370.jpg\",\"keywords\":[\"APIs\",\"integrations\",\"Intercom\",\"platform\"],\"articleSection\":[\"News & Updates\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/\",\"url\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/\",\"name\":\"Automate and Integrate with Intercom's new APIs\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/wp-content\\\/uploads\\\/2014\\\/06\\\/API_Blog_370.jpg\",\"datePublished\":\"2014-06-17T09:23:07+00:00\",\"dateModified\":\"2020-07-30T12:03:55+00:00\",\"description\":\"Today we\u2019re announcing the new Intercom APIs, an important step in creating a great platform for developers to integrate Intercom with other products.\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/new-intercom-api\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/wp-content\\\/uploads\\\/2014\\\/06\\\/API_Blog_370.jpg\",\"contentUrl\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/wp-content\\\/uploads\\\/2014\\\/06\\\/API_Blog_370.jpg\",\"width\":370,\"height\":230},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/\",\"name\":\"The Intercom Blog\",\"description\":\"Articles and Podcasts on Customer Service, AI and Automation, Product, and more\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/#organization\",\"name\":\"The Intercom Blog\",\"url\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/wp-content\\\/uploads\\\/2019\\\/08\\\/Intercom-logo-sq-black-trans.png\",\"contentUrl\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/wp-content\\\/uploads\\\/2019\\\/08\\\/Intercom-logo-sq-black-trans.png\",\"width\":1000,\"height\":1000,\"caption\":\"The Intercom Blog\"},\"image\":{\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/intercominc\",\"https:\\\/\\\/x.com\\\/intercom\",\"https:\\\/\\\/www.instagram.com\\\/intercom\\\/\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/2491343\",\"https:\\\/\\\/www.pinterest.ie\\\/intercom\\\/\",\"https:\\\/\\\/www.youtube.com\\\/channel\\\/UCJG0MvLP03kyzzAkD-w98aQ\",\"https:\\\/\\\/en.wikipedia.org\\\/wiki\\\/Intercom_(company)\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/#\\\/schema\\\/person\\\/96e6d6cf68c7ecb85779703ff3c68311\",\"name\":\"Michelle Fitzpatrick\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/ebb816543f1d3c1ed00613e7b4d8e5455c0dfb2553a26ea508dc90fd7ae024bf?s=96&d=mm&r=pg54a4947666af34261b3a36e98d8a20d9\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/ebb816543f1d3c1ed00613e7b4d8e5455c0dfb2553a26ea508dc90fd7ae024bf?s=96&d=mm&r=pg\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/ebb816543f1d3c1ed00613e7b4d8e5455c0dfb2553a26ea508dc90fd7ae024bf?s=96&d=mm&r=pg\",\"caption\":\"Michelle Fitzpatrick\"},\"description\":\"Food lover, math nerd, design obsessed, pun loving :) Product Manager @intercom\",\"sameAs\":[\"https:\\\/\\\/x.com\\\/shelliefitz\"],\"url\":\"https:\\\/\\\/www.intercom.com\\\/blog\\\/author\\\/shelliefitz\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Automate and Integrate with Intercom's new APIs","description":"Today we\u2019re announcing the new Intercom APIs, an important step in creating a great platform for developers to integrate Intercom with other products.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/","og_locale":"en_US","og_type":"article","og_title":"Automate and integrate with Intercom\u2019s new APIs","og_description":"Today we\u2019re announcing the new Intercom APIs, an important step in creating a great platform for developers to integrate Intercom with other products.","og_url":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/","og_site_name":"The Intercom Blog","article_publisher":"https:\/\/www.facebook.com\/intercominc","article_published_time":"2014-06-17T09:23:07+00:00","article_modified_time":"2020-07-30T12:03:55+00:00","og_image":[{"width":370,"height":230,"url":"https:\/\/www.intercom.com\/blog\/wp-content\/uploads\/2014\/06\/API_Blog_370.jpg","type":"image\/jpeg"}],"author":"Michelle Fitzpatrick","twitter_card":"summary_large_image","twitter_creator":"@shelliefitz","twitter_site":"@intercom","twitter_misc":{"Written by":"Michelle Fitzpatrick","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/#article","isPartOf":{"@id":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/"},"author":{"name":"Michelle Fitzpatrick","@id":"https:\/\/www.intercom.com\/blog\/#\/schema\/person\/96e6d6cf68c7ecb85779703ff3c68311"},"headline":"Automate and integrate with Intercom\u2019s new APIs","datePublished":"2014-06-17T09:23:07+00:00","dateModified":"2020-07-30T12:03:55+00:00","mainEntityOfPage":{"@id":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/"},"wordCount":704,"publisher":{"@id":"https:\/\/www.intercom.com\/blog\/#organization"},"image":{"@id":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/#primaryimage"},"thumbnailUrl":"https:\/\/www.intercom.com\/blog\/wp-content\/uploads\/2014\/06\/API_Blog_370.jpg","keywords":["APIs","integrations","Intercom","platform"],"articleSection":["News & Updates"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/","url":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/","name":"Automate and Integrate with Intercom's new APIs","isPartOf":{"@id":"https:\/\/www.intercom.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/#primaryimage"},"image":{"@id":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/#primaryimage"},"thumbnailUrl":"https:\/\/www.intercom.com\/blog\/wp-content\/uploads\/2014\/06\/API_Blog_370.jpg","datePublished":"2014-06-17T09:23:07+00:00","dateModified":"2020-07-30T12:03:55+00:00","description":"Today we\u2019re announcing the new Intercom APIs, an important step in creating a great platform for developers to integrate Intercom with other products.","inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.intercom.com\/blog\/new-intercom-api\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.intercom.com\/blog\/new-intercom-api\/#primaryimage","url":"https:\/\/www.intercom.com\/blog\/wp-content\/uploads\/2014\/06\/API_Blog_370.jpg","contentUrl":"https:\/\/www.intercom.com\/blog\/wp-content\/uploads\/2014\/06\/API_Blog_370.jpg","width":370,"height":230},{"@type":"WebSite","@id":"https:\/\/www.intercom.com\/blog\/#website","url":"https:\/\/www.intercom.com\/blog\/","name":"The Intercom Blog","description":"Articles and Podcasts on Customer Service, AI and Automation, Product, and more","publisher":{"@id":"https:\/\/www.intercom.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.intercom.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.intercom.com\/blog\/#organization","name":"The Intercom Blog","url":"https:\/\/www.intercom.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.intercom.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.intercom.com\/blog\/wp-content\/uploads\/2019\/08\/Intercom-logo-sq-black-trans.png","contentUrl":"https:\/\/www.intercom.com\/blog\/wp-content\/uploads\/2019\/08\/Intercom-logo-sq-black-trans.png","width":1000,"height":1000,"caption":"The Intercom Blog"},"image":{"@id":"https:\/\/www.intercom.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/intercominc","https:\/\/x.com\/intercom","https:\/\/www.instagram.com\/intercom\/","https:\/\/www.linkedin.com\/company\/2491343","https:\/\/www.pinterest.ie\/intercom\/","https:\/\/www.youtube.com\/channel\/UCJG0MvLP03kyzzAkD-w98aQ","https:\/\/en.wikipedia.org\/wiki\/Intercom_(company)"]},{"@type":"Person","@id":"https:\/\/www.intercom.com\/blog\/#\/schema\/person\/96e6d6cf68c7ecb85779703ff3c68311","name":"Michelle Fitzpatrick","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/ebb816543f1d3c1ed00613e7b4d8e5455c0dfb2553a26ea508dc90fd7ae024bf?s=96&d=mm&r=pg54a4947666af34261b3a36e98d8a20d9","url":"https:\/\/secure.gravatar.com\/avatar\/ebb816543f1d3c1ed00613e7b4d8e5455c0dfb2553a26ea508dc90fd7ae024bf?s=96&d=mm&r=pg","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/ebb816543f1d3c1ed00613e7b4d8e5455c0dfb2553a26ea508dc90fd7ae024bf?s=96&d=mm&r=pg","caption":"Michelle Fitzpatrick"},"description":"Food lover, math nerd, design obsessed, pun loving :) Product Manager @intercom","sameAs":["https:\/\/x.com\/shelliefitz"],"url":"https:\/\/www.intercom.com\/blog\/author\/shelliefitz\/"}]}},"jetpack_featured_media_url":"https:\/\/www.intercom.com\/blog\/wp-content\/uploads\/2014\/06\/API_Blog_370.jpg","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/posts\/5795","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/users\/94"}],"replies":[{"embeddable":true,"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/comments?post=5795"}],"version-history":[{"count":0,"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/posts\/5795\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/media\/5798"}],"wp:attachment":[{"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/media?parent=5795"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/category?post=5795"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/tags?post=5795"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.intercom.com\/blog\/wp-json\/wp\/v2\/coauthors?post=5795"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}