API & Webhooks

I’m using the /admins endpoint to fetch a list of customer support agents. The response contains only a partial list of the agents. How can I get the full list?

Hello, We are building a custom dashboard integrating our systems and would like to be able to retrieve how many tickets and its category in a specific period. Is it planned to be implemented?Thanks 

Hello everyone! I’m new to Intercom and not a developer but I’d like to know how do I use these Javascript API: Methods in my Intercom deployment, specifically. Intercom('shutdown') and Intercom('update')Intercom('shutdown');Intercom('update');where should I place these scripts into?  Thanks!

I’m creating a Custom Action using Stripe’s APIs. This is a POST request and every time I get this error message:{ "error": { "message": "One of the following params should be provided for this request: payment_intent or charge.", "request_log_url": "https://dashboard.stripe.com/test/logs/req_RDcf26d1WJ3G95?t=1694494393", "type": "invalid_request_error" }}Here’s what the request and headers look like:And here’s what the request body looks like, which you can see includes the “charge” parameter: 

Hi there!I subscribed on content_stat.post event, but the webhook triggers only when user open the intercom webpage.We are using embbed webComponent in our application and would like to notify user about it before he opened the web page (because he must do it manually), we want to open it programmatically - when new post are created - open this page immediately, but we discovered that webhook triggers only after opening webpage by user. How can i detect that new post are created for user, before he opened page? Ideally via webhook, or at least API?Thanks!

we have created an app, with a webhook directing to our platform, it was working fine, but suddenly somewhere today, the event "conversation.user.created" and "conversation.user.replied" are not sent.

I’m building a custom action that will send a POST request to Shortcut to create a Story.  I’ve tested in Postman and it works fine, but when I use the exact same request body in Intercom, I’m getting a message back that I’m missing a parameter (the missing parameter happens to be the only required parameter).  I can recreate this error in Postman by commenting out (or removing) the parameter in question.  Otherwise, it always succeeds in Postman.How does Intercom present the body in these requests?  Does it do it exactly as-is, or does Intercom apply some formatting?  Since it works fine in Postman, I’m kinda thinking that Intercom is changing something.To be more specific, when creating a Story via Shortcut’s API, the only required parameter is “name”.  If my request body in Intercom is this:{"name": "Just a test card from Intercom"}I get this message:400 Bad Request{"message":"The request included invalid or missing parameters.","errors":{"name":"missing-required-key"}} Works fine i

Hi everyone,I have a WordPress website and have recently added intercom. The website itself doesn't have a function (or market need) to log users in, but I'd still like to remember and prefill their details across the website once they've entered their details once before (in the chat app, or website forms).For example​, I have a quote form and if Intercom has the name and email stored I would like it to be pre-populated into the form (and vice versa).My question is, how can I achieve this? Intercom doesn't appear to have a JS method to get the current user details.Thanks in advance!Sam.​

Hello,We are switching workspaces in Intercom and we want to keep all the conversation data from the old space.The data has been pulled from the API in JSON format.How can we use this data so it is kept in a way that is organised and searchable by keywords?Does anyone have experience with this process?All the help and guidance will be highly appreciated. Thanks. 

Hi, i use Webhook from Intercom, i want to notify user that conversation created or some participant in the conversation (admin for instance) are replied. but the webhook payload “admin.replied” or “user.replied” does not contain email of the participants, there only admin email, how can i retrieve email of receiver user?For example: Admin replied to Uncle Bob in private conversation (Uncle bob email is: uncle@bob) but how to get Bob’s email without direct interaction with API, using only webhook?Thanks!

Hello, I am trying to fetch all articles and I keep getting CORS error no matter what I try. I tried to set the headers as mentioned here https://developers.intercom.com/docs/references/rest-api/api.intercom.io/Articles/listArticles/, adding also access allow control origin header but I can’t get the data. I get it in postman with no issue. What am I missing? Working with RTK Query.

Hi, We’re using v1.4 of the API to query and update users in our (Google) cloud services. However all of a sudden the requests are return a 403 status code with a HTML body - also there are no other usual Intercom response headers (x-request-id, x-ratelimit-limit, etc.) present so I can’t even provide a request ID trace to debug with. <html><head><title>403 Forbidden</title></head><body><center><h1>403 Forbidden</h1></center></body></html>Headers:connection: keep-alivecontent-length: 118content-type: text/htmldate: Thu, 22 Jun 2023 15:54:21 GMTserver: awselb/2.0 It’s not an issue with the authentication or request as if I run curl with the same request it succeeds with a 200 status code.Has Intercom blocked our cloud services (Google Cloud Run) IP or something? A simple request such as the below fails when run in the cloud:curl -i -H 'accept: application/json' -H 'intercom-version: 1.4' -H 'authorization: Bearer &l

Context:I’m using the Intercom <=> Jira cloud integration to link my Intercom Conversations and Tickets to related Jiras.A limitation with this integration is that it doesn’t write the Jira ID to the Intercom data objects, it writes to a Jira field ‘linked_intercom_conversations.’ This means I can’t search or do any reporting in Intercom for Conversations/Tickets related to Jiras.To solve this, I wrote a tool to pull the Intercom IDs from the Jira fields, and update a data attribute in Intercom with the Jira ID that was linked.Here’s the problem:When the ‘linked_intercom_conversations’ is written to the Jira it always writes the url ID to the  field. This means that all of the linked objects look like conversations. Because Intercom doesn’t share data attributes across conversations and ticket types, it takes a different API call to update a ticket vs a conversation. But I can’t tell from the ID on the Jira which type is is.I tried doing a call to api.intercom.io/conversations/CA

I am tying to query conversations (via python) and my payload is as follows payload = {  "query": {    "operator": "AND",    "value": [        {          "field": "state",          "operator": "=",          "value": "open"        },        {          "field": "admin_assignee_id",          "operator": "=",          "value": "123456"        },        {          "field": "waiting_since",          "operator": "<",          "value": 1693564392        }      ]  }} The above logic should be, show me conversations where state = open AND admin_assignee_id = 123456 AND waiting since is less than 1693564392. The response however includes conversations that have a “state” = “closed” What am I doing wrong ? Your docs state AND operators can have upto 15 filters.  

Hi,I am using webhooks and trying to identify an event of ‘conversation.admin.opened’ when a lead replies on a closed ticket but it doesn’t seem to trigger it. the odd thing is that it works on one workspace but not on the other.

According to the API documentation, something like this should workPOST{    "message_type": "comment",    "type": "user",    "body":"<h1>hello world</h1>",    "intercom_user_id":""}but instead I get a "user is an invalid value for type" error - even though the API explicitly says that it is. I do note that the page linked only has an admin note reply as an option in the dropdown. Does that mean that it is not possible to post a reply on behalf of a user?  Would appreciate any help here.

Hi, New to IC and have set up a Custom Object. My thinking was first to push data to the Custom object from our Bubble app as soon as the data changes in the Bubble app. However, according to https://www.intercom.com/help/en/articles/6298280-setting-up-a-custom-objectthere's no API yet to use for pushing data from my Bubble app to IC, right? So, I guess I need to create a Custom Action that then can be used in a Bot to in real time retrieve the data need? Best, Peter

Previously, User contacts were only created in Intercom when they first logged into our platform. Because of this, we could treat the First Seen field as a reliable indicator of the first time a user actually logged in. Knowing the time between “signed_up_at” (i.e. user provisioning) and “First Seen”(i.e. user login) is very useful. We are making some changes which means we will pre-create users in Intercom via API when their accounts are provisioned. Users created via API have First Seen automatically populated as the time they are created in Intercom. Is there a way to null this field, or otherwise reset/overwrite/etc? I guessed at “first_seen_at” as the field name since it’s not listed in the docs. Anyone else have this issue or solved it a different way?

Hello!I hide my Intercom widget on some pages of the app using Intercom('update', {hide_default_launcher: true});.The problem is that the user still hears messages sound even when the chat is hidden.Is there any way to mute the chat?Or any other methods to hide chat completely, including the sound? 

Hi, I’m trying to use a snippet code i got from your developer party, 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.Any clue?  const str = JSON.stringify({ query: { value: [ {field: 'created_at', operator: '>', value: '1690081199'}, {field: 'created_at', operator: '<', value: '1690167601'} ], operator: 'AND' } }); const options = { method: 'POST', headers: { accept: 'application/json', 'content-type': 'application/json', authorization: 'Bearer XXXXXXXXXXXXXXXXXXXXXX' }, body: str }; const response = UrlFetchApp.fetch('ht

We’re trying out the canvas app. When we pass the header and text components, the Canvas is loading correctly in the Inbox.This is the request body: {    "canvas": {        "content": {            "components": [{                "type": "text",                "text": "Create Case in SF",                "style": "header",                "label": "sf create case",                "align": "center"            }, {                "type": "text",                "text": "his is a text component."            }]        }    }}But, when we try to add a button as well, along with the text components, it is showing an error.{    "canvas": {        "content": {            "components": [{                "type": "text",                "text": "Create Case in SF",                "style": "header",                "label": "sf create case",                "align": "center"            }, {                "type": "text",                "text": "his is a text component."            }, {                "ty

Getting more and more timing out or internal server errors. Anyone else has the same issue?

Hi!  I have a question about which to rely on in the API v2.9 Models documentation: the example JSON object, or the documented fields / field datatypes.  In some cases the inconsistencies can be significant.  For example, in looking at https://developers.intercom.com/intercom-api-reference/reference/the-contact-model I can see the following differences:Documentation does not include the external_id field from the example JSON. Documentation lists avatar as having type object but in the example object it has type string. Documentation does not include the opted_out_subscription_types field from the example JSON. Documentation does not include the opted_in_subscription_types field from the example JSON. Documentation does not include the utm_campaign field from the example JSON. Documentation does not include the utm_content field from the example JSON. Documentation does not include the utm_medium field from the example JSON. Documentation does not include the utm_source field from the

Hey! I try to build an auto respond integration but I have a problem with sending a message to the Customer using an API.I’m using https://github.com/intercom/intercom-node as a library for communication with intercom API. When I try to reply to the conversation using the adminID and I’ll provide operator user ID everything seems fine at the first glance so:api doesn’t return any error, message is added to the conversation in the inbox,But unfortunately email never arrives to the user.When I use different adminID everything works fine. I tried to search in the docs but I didn’t see if there are some limits related to sending a message as an operator. So my questions are: Is it possible to reply to the conversation using an Operator from the API?If it is possible do I need to add some extra configuration for the Operator in order to send messages to the user.

Our platform uses our own Intercom instance for chat support, but a recent integration provided us with a second Intercom instance to also include in our application for customers to reach out to their support as needed.  I have been looking for documentation about the feasibility of this, but have been unable to locate any across the site. For our instance, we use the Intercom JavaScript library loaded by Segment.  Our instance uses the identify verification functionality, but the new instance to be included does not. Thanks for any insight into the feasibility of this, as well as any supporting documentation.