API & Webhooks

Hey!We are creating tickets for some chats and sending the ticket attributes to an external tool using POST API requests. I’m able to forward all attributes except for any files added to the ticket, as the file attribute isn’t saved like the others.Is there a way to include links to the files in my API call through the Action Builder? I see that the files are stored like this, so I would just need a way to include this in the call. https://downloads.intercomcdn.com/i/o/qwum5ehb/1430332547/0a18547e88a0534a2b11dc66de1c/About+-+Wolt+%28Germany%29.pdf?expires=1742396400&signature=71937dcca587c48f453

Hello, I have a custom action that is supposed to send a request to my server along with multiple url params attached.The problem is however, not ALL of the params are sent for every request. Yet, since they are declared in the Request section of Custom Actions the call fails presumably because not every param has a value. The questions are, 1.) are we able to set these params to be “optional” and I’m just missing the option? 2.) Why can’t Intercom just recognize that this param is empty, and input a null, or avoid the param all together and leave validation up to the server receiving side? AKA, my server.I just feel like this product is feature limited to the point its useless, at least for my use case. And yes, I have tried for hours to Google, watch Youtube videos, browse articles (

Hi team,We're implementing the require-trusted-types-for 'script'; header in our app and have set up a default Trusted Types policy. However, the Intercom widget script fails on the following line:e.documentElement.innerHTML = t,withUncaught TypeError: Failed to set the 'innerHTML' property on 'Element': This document requires 'TrustedHTML' assignment. Has anyone encountered this issue before? Any suggestions on how to work around it while keeping Trusted Types enforcement?Thanks! 

Hi guys,As far as I know, currently there is no option for sending Whatsapp templates via REST API (correct me if I’m wrong). Whatsapp don’t allow sending messages via their API directly if the number is already connected to your system. That leave us without options in order to have only 1 single point of contact number for receiving user’s questions and being able to automate templates for our users. Other competitors (like Messagebird) already allow to send whatsapp templates via their API.So the question is, is there any plan to allow this in your API? Is there any ETA? This feature is quite important and if there is no plan to implement it would make customers contemplate switching providers. Thanks in advance.

I'm experiencing an issue when using the Intercom API to search for tickets. When I try to search for a title that contains spaces, the API does not return the expected results. For example: The query below returns the ticket correctly: { "query": { "field": "title", "operator": "~", "value": "Atraso" } } However, when I add a space after "Atraso", no results are returned: { "query": { "field": "title", "operator": "~", "value": "Atraso " } } I have already tried the following approaches without success: Using regular expressions with \b Encoding the space as %20 Using the exact match operator "=" Expected result :[ { "type": "ticket.list", "pages": { "type": "pages", "page": 1, "per_page": 20, "total_pages": 1 }, "total_count": 1, "tickets": [ { "

Hello,I am using Intercom API in a GCP cloud run to do several things, especially updating a user.Sometimes it works, but sometimes I get an 401 error: “token_not_found”, and I checked multiple times with logs: I am always sending the access token and it’s the right one. “intercom_user_id” is also the right one.I also checked multiple times my server and logic, and there’s no error.Here are some request ids where this error happened: 0003sad4ua316ingi1l0, 000an1qat9nc63bsg160, 0021017ivsn8tt93ipd0.Here is the call in python:url = f"https://api.intercom.io/contacts/{intercom_user_id}"headers = { "Authorization": f"Bearer {settings.INTERCOM_ACCESS_TOKEN}", "Intercom-Version": "2.12", "Content-Type": "application/json",}update_dict = intercom_profile.model_dump()try: response = await httpx_client.put(url=url, headers=headers, json=update_d

I am doing research on fetching data from my intercom account and save to another platform. In the way i just wanted to know if i can fetch anyone's app created app credentails i.e client_id,client_secret using account username and password. I have also gone through the api doc provided by Intercom but didn't found anything relevant to this.  So anyone can tell me whether it is possible in Intercom or not?

Has anyone ever seen an issue with the conversations API returning the wrong type for a conversation part? I’m working with a customer and we’re seeing an issue where sometimes the API returns conversation parts with a type = “assignment” but it should be a “comment” or a “note”. I have an example I can share if that is helpful.

Hi, nice to meet you!First of all, I want to apologize if there is any misunderstanding. My native language is Spanish, and I wrote this message myself, with a review by ChatGPT.I'm here because I have a small issue with a specific functionality, specifically the /tickets/search endpoint.The main issue is that I have two types of tickets. To give you an example, one type is for delayed shipping, and the other is for requesting a shipment cancellation. In both cases, when I create the ticket, I send an extra attribute called tracking_number. Both types of tickets are created correctly with this extra parameter and the necessary data.Now, here’s the issue: when I try to search, I do it like this: As you can see, I can't find any results. However, when I sea

Hello,I am using Intercom API in a GCP cloud run to do several things, especially updating a user.Sometimes it works, but sometimes I get an 401 error: “token_not_found”, and I checked multiple times with logs: I am always sending the access token and it’s the right one. “intercom_user_id” is also the right one.I also checked multiple times my server and logic, and there’s no error. It’s happening both in production and test mode.Here are some request ids where this error happened: 0003sad4ua316ingi1l0, 000an1qat9nc63bsg160, 0021017ivsn8tt93ipd0.Here is the call in python:url = f"https://api.intercom.io/contacts/{intercom_user_id}"headers = { "Authorization": f"Bearer {settings.INTERCOM_ACCESS_TOKEN}", "Intercom-Version": "2.12", "Content-Type": "application/json",}update_dict = intercom_profile.model_dump()try: response = await httpx_c

Hi Intercom,We're building tools to help our team manage help center content more efficiently, but we've encountered a discrepancy that's causing some challenges.Currently, the article ID returned through the Articles API (/articles endpoint) doesn't include the activeContentId required in the Intercom app URL for editing articles. For example:API response article ID: 10515400 Required activeContentId in URL: 11181100 (e.g. https://app.intercom.com/a/apps/ej501111/knowledge-hub/all-content?activeContentId=111811--&activeContentType=article&editorMode=view)This means we can't programmatically generate direct links to the article editor in the Intercom app using the data from the API response.

Hello everyone, i would like to know how can i solve this problem:I made a  part of my chatbot with botpress so i created an app to integrate botpress in my intercom chatbot. Nevertheless, i’m strugguling with integrating it in my workflow, this message shows. How can i make this thing work please ? 

Hi everyone,I’m working with a Custom Action in Intercom, where I send a POST request that includes a variable from the conversation data. However, sometimes this variable is missing for certain conversations, which causes the POST request to fail.Is there a way to create a fallback or default value for such variables in the request body to prevent the failure?For example, here’s my current setup:If data is not available, how can I ensure the request still goes through, possibly by setting a default value (like null or a placeholder string)?Any advice or examples specific to handling this in a Custom Action would be greatly appreciated.

We have many conversations in the backlog with a specific tag. We want to implement a simple Python script that uses an API to find and close these conversations. After closing them, the script should send a message to those chats to inform the users about the closure. How can this be implemented?

I’m looking for a way to automate sending  (or correctly scheduling) messages from Intercom Outbox to customers.Current the way it’s done is manual:3 message templates, each with own url rules ands scheduled Each of them get scheduled and stopped at a separate time to send to customersI’m unable to find a way to currently automate this with the API (either with Messages API https://developers.intercom.com/docs/references/rest-api/api.intercom.io/messages/createmessage or even with Events API (https://developers.intercom.com/docs/references/rest-api/api.intercom.io/data-events/createdataevent)  

When updating an article with the API, I am finding that any blank paragraphs in the article are stripped away. This is somewhat annoying, as we often use blank paragraphs as a way to have some padding below text before the next paragraph, heading, or image.More specifically, we may export an article with a blank paragraph that is marked up with ‘\n<p class=\"no-margin\"></p>\n’. If we feed that body directly back into the article to update it, that entire block of HTML is removed. Is there any way to preserve this?The below image shows the blank line added between the first two lines of the article. And here we see that spacing has been stripped away: 

I’d like to retrieve changes or additions to the company data from yesterday or last month in batch.Since I have not seen a way of filtering the api query to companies I wonder how to best achieve this. From what I see I have to use the “Scroll over all companies” or “List all companies” API retrieving all Companies and filter the result according my needs.Any other suggestions are very well appreciated, thanks.

Hello everyone,I’m Darshan Hiranandani, I’ve been working on an API that allows me to create articles with titles and main content. So far, I’ve been able to create articles successfully, but I’m facing a challenge when it comes to uploading images or attachments to these articles.I know some platforms like Intercom have hosting services that allow you to upload and store attachments, but I’m not sure if they offer something similar for direct image uploads.Can anyone share their experience or suggestions on how to upload images or attachments via REST API? Any help or ideas on how to handle this would be greatly appreciated!Thanks in advance!RegardsDarshan Hiranandani

We currently face a limitation in tracking ticket ratings timestamps. While conversation ratings are provided through webhook events, ticket ratings are not, forcing us to use the ticket closing date as a fallback. This creates inaccurate data when tickets are rated after their closure. This appears to be an oversight as this functionality is already available for conversations This limitation affects our ability to: Accurately track CSAT metrics over time Report precise customer satisfaction data Maintain data integrity when tickets are reopened Provide reliable analytics to our customer service teams We propose adding new webhook events for ticket ratings, similar to the existing conversation rating events. These events should include the same information as the conversation_rating_event. This also means we need a ticket_rating_updated_event when a ticket rating is modified.

Trying to use intercom URL in iFrame, facing the error which says "ancestor violates the following Content Security Policy directive: "frame-ancestors 'self' " Need a solution to overcome this issue. Kindly help us to resolve this

I’m referencing this documentation: https://developers.intercom.com/docs/references/rest-api/api.intercom.io/conversations/updateconversation I’ve created a custom attribute on conversations called original_post_id (see below)And i’ve been successfully able to PUT https://api.intercom.io/conversations/{id} (200 response code) with the intention of updating the conversation with a custom attribute value:

Can we get list of all articles in a collection using the REST API?

Hi everyone,I’m Darshan Hiranandani, I’ve been using the Intercom interface to create notes, and I noticed that I can tag teammates in those notes. However, I’m wondering if it’s possible to do the same when creating notes through the Intercom API.Has anyone had experience with this or know if tagging users is supported when creating notes via the API? Any insights or guidance would be really helpful!Thanks in advance!RegardsDarshan Hiranandani

I have created a Python code with using API requests to fetching conversations by different words.However, when I try finding two words that contain in the conversations, it will not response me with any emails.Code here:import requestsimport csv# Replace with your Intercom access tokenaccess_token = 'PUT-YOUR-API-HERE'# URL for searching conversationsurl = "https://api.intercom.io/conversations/search"# Headers for authenticationheaders = {    "Intercom-Version": "2.11",    "Authorization": f"Bearer {access_token}",    "Accept": "application/json",    "Content-Type": "application/json"}data = {    "query": {        "operator": "AND",        "value": [            {                "field": "source.body",                "operator": "~",                "value": "two words"            }        ]    },    "pagination"

Hi there,I'm attempting to obtain the content message of outbound messages using the content_stat.sms webhook.However, the data received only includes the content_title.Could you please guide me on how to retrieve the full content message of outbound messages through the API or webhook?Thank you.