API & Webhooks

Hello, We would like to pull the following Intercom Reporting Metrics via the API. We are looking at the documentation here https://developers.intercom.com/docs/references/rest-api/api.intercom.io/conversations/conversation. That being said, we are having a hard time matching the following. Please let us know if there is documentation on how to pull the metrics listed below. Time to Close - Bot inbox time includedFirst response time, excluding bot inbox time and within office hoursReplies per conversationCSAT scoreConversations openNew Tickets  

In the "Developer Hub" section, we have set up the API version "1.4", this version is used in all our clients.In the old API versions (for example, in 1.4), there is a method "Create or Update User". In the new API versions (for example, 2.11), the endpoint "api.intercom.io/users" is not described, but there is a Contacts documentation section, which describes similar methods.Can we simultaneously use the old API version 1.4 for user management (through calls to "api.intercom.io/users") and the new API version 2.11 (through calls to "api.intercom.io/contacts"). For calls to the new Contacts API, we plan to use the HTTP header 'Intercom-Version': '2.11'.Will such use of two different API versions break the logic of Intercom, will user/contact data be lost?

Hi Team,I’m working on a task that involves extracting data from my workspace and uploading it to another system. I’d greatly appreciate any detailed suggestions or best practices you might have for this process. Best regards,Darshan Hiranandani

Hello, I reviewed the API documentation and noticed that there are only APIs for Admin users.Is there an API for fetching all users; admins and non-admin alike? Thanks in advance,

Hi,I had opened a ticket which was flagged as solved, but it’s not solved.  I’m trying to use a snippet code i got from your developer website, to search conversations between two epochs. The codes runs without a problem on your platform, but when I use it in google scripts I get the response:{"code":"invalid_query","message":"Query body must contain a query hash"}I guess it is related to the JSON payload, though the string seems to be ok.I was able to work with the API without any problem, when I don’t send a body, but I always get the error whenever I include a body.I do have the ‘application/json’ in the code (the snipped below was copied directly) and I’ve tested removing the apostrophes from ‘content-type’ and I still get the same error.I’m adding a screenshot of the data structure in my memory. All looks as it should.Any clue?   const str = JSON.stringify({ query: { value: [ {field: 'created_at', operator: '>', value: '1690081199'}, {field: 'crea

Is there any way to insert articles into messages using the api or sdk?

Is it possible to share prepared articles from the "Help" section in the Intercom chat on Telegram and WhatsAppusing a chat bot? I am not looking for pre-made solutions available on the internet, but rather want to know whether such functionality is available.For example, if a customer contacts support via Telegram and we send them a pre-prepared article from the Help section, is it possible for the customer to view it? Since articles from this section are not sent in text form, but instead through pop-up windows with hyperlinks, is there any way to make this information accessible to the customer?

Hi, I am using Make (formerly Integromat) to automate data exports. So I’m following this API call in the documentation : https://developers.intercom.com/intercom-api-reference/reference/create-data-exportTo do so in Make, I use the Intercom module “Make an API call” with a POST request (see attached picture) with the right URL endpoint : /export/content/data. (as mentioned in the doc) And with two dates with the right format in timestamp (I took June 1st and June 30th for the example). But when I try it I get a 401 error “unauthorized”.I don’t understand because in other automations I use the exact same module to Search contacts. In this case it is still a POST request and what changes are :the URL endpoint is : /contacts/search And the parameters of the query but it works.  I don’t understand what’s going on and overall : I don’t know how to get the authorization 😬I tried to create another connection and to re-do the process to authorize Make to access Intercom and vice versa but it

Hello, I’m new to the Intercom API and I encountered an error when using the “Convert a conversation to a ticket” api.  The error is ‘errors': [{'code': 'server_error', 'message': 'Server Error'}] What should I do? Is there a solution for this problem?

Is it possible to get to this screen with the Intercom JS API?  

Hi!We’ve been having issues with our Salesforce Integration and FIN. We have our integration set up where FIN creates cases in Salesforce for each conversation, but that’s not happening anymore. We have already checked to make sure the mapping is correct and the conversations are with customers, not leads, nothing is working.

Hello, since we are using our own notifications implementation using AWS amplify, we currently rely on the webhook to send Intercom notifications for our users. To send a push notification when creating a new chat message trough Proactive support we listen for the 'content_stat.chat' topic and stat_type: 'receipt'. However, for some users this event is only sent when they open the app, for other users (so far I could only make it work for one at a time) this event is sent even when they have the app on the background (which is the behavior I want). What is the behavior of this event, and how can I make it work for multiple users at the same time? I don’t want them to have the app open for this notification to arrive.If listening for this event is not a reliable way of sending push notifications when chat messages are sent, is there any alternative way of making Intercom Notifications work alongside amplify notifications?

I’m trying to add tags to users via APi but is not working, Are there any diferences between contacts and users?I tryed using both and was not sucessful.I’m doing this http request but nothing is happening to the user tag  

I think the webhook body has changed when a user sends a message,For the first message a user sends, I see the below. The body used to have the user’s message, but now it’s null. Also it’s a new part_type `language_detection_details`Anyone else notice this? "conversation_parts": { "type": "conversation_part.list", "conversation_parts": [ { "type": "conversation_part", "id": "2322", "part_type": "language_detection_details", "body": null, "created_at": 1718102859, "updated_at": 1718102859, "notified_at": 1718102859, "assigned_to": null, "author": { "id": "7189586", "type": "bot", "name": "Fin AI", "email": "operator+wed4314z@intercom.io" }, "attachments": [], "external_id": null, "redacted": false } ], "total_count": 1 } } }

Hi everyone,I've recently upgraded from Intercom API version 2.3 to 2.11 and I'm encountering some issues. I understand that sections are now deprecated and are accessed via collections. I'm able to update the section names using the new path help_center/collections/{id}.However, when I try to use translated_content, I receive the following error:{ "type": "error.list", "request_id": "0001t87jrm46e5t3rtp0", "errors": [ { "code": "not_found", "message": "Resource Not Found" } ]} Has anyone else experienced this issue or can provide guidance on how to correctly use translated_content in version 2.11? Any examples, workarounds, or documentation links would be highly appreciated.Thanks in advance for your help! 

Title + I understand I have to use the Intercom API somehow, but I'd like a little more guidance.

Hi there!Going crazy over here. Trying to add a Vimeo iframe to my article by API.When it’s youtube, it works fine, but with Vimeo - no matter the URL I choose I always get “video src not supported”.The article creation works well and I am just trying to add a vimeo iframe to it.here is a fake video I created an uploaded This will not pass API validation “video src not supported” (but will work if I add it from the UI): <iframe src="https://player.vimeo.com/video/956950834?h=adfcdc69e8"></iframe> This will pass API validation but the URL is missing the h parameter and Vimeo cannot read: <iframe src="https://player.vimeo.com/video/956950834"></iframe>What can I do? I also tried multiple version of the vimeo URL - no luck.Let me know!

I’m writing a helper app that adds notes to conversations and would like to be able to format the contents.Basis HTML seems to work OK but I’d like to add a code block and a table and neither are well supported. Can anyone point me at the correct documentation or provide other guidance?

Having to first search by External ID, then grab the correct Intercom-provided User ID and then calling DELETE seems like a lot of steps to be able to delete someone when you already know the External ID. Is there a better way? Can a better way be made? Doing one call to delete a contact's data instead of three would benefit Intercom too, right? 

Description:I am encountering issues while integrating Intercom webhooks using OAuth. Although the OAuth flow works and I can obtain access tokens, I am unable to create webhooks due to unauthorized token issues. I have selected all  available scopes in the Intercom Developer console, but the issue persists.Error: {  "type": "error.list",  "requestid": "003avbbpvjpgktcsppvg",  "errors": [    {      "code": "token_unauthorized",      "message": "Not authorized to access resource"    }  ]}How To Reproduce:Request URL / Headers:  URL:  POST https://api.intercom.io/subscriptions Headers: Authorization: Bearer <access_token> Authentication method or app type: OAuth 2.0 errors: token_unauthorized: Not authorized to access resourceLet me know if you need any additional details.Could you please assist in resolving this issue so that I can successfully create webhooks?Thank you for your support.

Hi, I’m Darshan Hiranandani, How does the API handle large datasets when performing bulk user operations? Are there any specific mechanisms or best practices in place to ensure efficient processing and minimal performance impact? Have anyone any suggestion and idea please share.  

I’m trying to create notifications for conversations initiated and/or replied by users. However, I am unable to save the webhook with the selected topic(s). I see a popup that says “Your webhook settings were successfully updated and a test request was sent successfully” but the topics are not saved to the webhook.

I send a message user the api: Reply to a conversation,How do I get reply when customer reply ?I need to subscribe conversation.admin.replied  this topic ?

Hello everyone,Our team, operating within the travel industry, heavily rely on API calls to extract valuable insights from our database (e.g. departure dates, company codes, destinations etc.) wihin Intercom workflows. We then save this information as custom object attributes.This setup was designed to facilitate detailed data analysis of our workload while saving our team time by automating the input process for each request.However, to our surprise, custom object attributes are not accessible through search, reporting, or exporting functions within Intercom. As a result, despite the data residing in Intercom, our team still needs to manually input it into conversation and people data to make it available for reporting and exports.Recognizing the significance of this time-consuming process, we're actively seeking a solution to automate it.Is it feasible to complete conversation and people attributes via an API call (bypassing reference option), or are there alternative workarounds to

Hello everyone,Our team, operating within the travel industry, heavily rely on API calls to extract valuable insights from our database (e.g. departure dates, company codes, destinations etc.) wihin Intercom workflows. We then save this information as custom object attributes.This setup was designed to facilitate detailed data analysis of our workload while saving our team time by automating the input process for each request.However, to our surprise, custom object attributes are not accessible through search, reporting, or exporting functions within Intercom. As a result, despite the data residing in Intercom, our team still needs to manually input it into conversation and people data to make it available for reporting and exports.Recognizing the significance of this time-consuming process, we're actively seeking a solution to automate it.Is it feasible to complete conversation and people attributes via an API call (bypassing reference option), or are there alternative workarounds to