API & Webhooks

The REST API has a method for merging contacts from lead to user. It works pretty simple:```curl -i -X POST https://api.intercom.io/contacts/merge \  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \  -H 'Content-Type: application/json' \  -H 'Intercom-Version: 2.10' \  -d '{ "from": "LEAD_ID", "into": "USED_ID" }'```Also, lead can be merged to user in the Intercom app. When lead is merged, our integration listen for webhook with topic `contact.merged`. This webhook has an information to what contact the lead was merged, but has a missing part from what lead: ```{

When admin replies with an article, webhook does not contain details about it. May we have a link to article in webhooks? 

Hi! When I use a specific IP address, all my POST requests to the api (https://api-iam.intercom.io/messenger/web/ping) return a 403 error. However, this does not apply to other ip addresses. Is it possible that my ip address is blocked?

Our application uses OAuth to get user’s access token. We noticed that after a while tokes are revoked and API calls fails with unauthorized errors. An example:```json{  "type": "error.list",  "request_id": "0003hg8qe7evlq01dqcg",  "errors": [{ "code": "unauthorized", "message": "Access Token Invalid" }]}```May I ask if access tokens obtained through OAuth have expiration date? If there a way to debug why token is invalid now?

I’m running into a problem when attempting to sync contacts from our platform.  Currently I’m doing the following:Call the contacts/search endpoint, searching by email address If Contact is found, update it If Contact is not found, attempt to create itI’m occasionally getting the following error on step #3:An archived contact matching those details already exists with id=123456 I cannot search for Contact 123456 in the UI.  If I attempt to GET the Contact through the API, I get an error “User Not Found”.I cannot blindly update the Contact because I don’t know their Intercom ID, and that’s the only way to call an update that I can find.So how do I locate and update these archived records?

I have an application with a few thousand users that I would like to create/update in intercom and synchronise at least weekly with attributes that are calculated by my backend and that are required for contextual engagement. The Contacts API does not support bulk updates and has two major constraints for large volume: i) it requires your app to understand whether a contact has already been created before calling with POST or PUT (the javascript SDK does not suffer from this); ii) the API rate limits are ridiculously small for any medium-sized user base (166 requests per 10s window, what???), which are even smaller if you need to check if a user exists before issuing either a POST or PUT. Furthermore, the Contacts API requires you to save the intercom id for a user for any updates, which is not user-friendly at all. The javascript SDK operates from the external_id provided (controlled by my app), while the REST API does not understand it at all and requir

Two questions on the Intercom webhooks (https://developers.intercom.com/building-apps/docs/webhooks - Are they all located the USA? - Are canvas kit webhooks from the same IPs? 

HelloWe are running into this error since this morning on the conversations end pointhttps://api.intercom.io/conversationsThis was working fine before for months and we didn’t change anything on our end. We are running 1000’s of api calls a day so the errors are running in the high thousands since this morning.  Anyone noticed anything ?  

Hello, I’m working on a new channel for Intercom. The service receive and forward messages between Intercom and 3th party chat app. When agent reply to chat, we receive related webhook and forward it to external app. There are cases, when we can’t forward the message (e.g. external service is down, or respond an error for particular user). Is there a way to notify agent about problem with sending particular message?

Hi I am trying to connect my Canny Changelog with intercom News. Ideally when a new changelog is created it would post on intercom news as well

When call API to create a conversation with empty `body` and one file attached, the API response with an error, but on https://app.intercom.com/a/inbox/ the chat appear.Here an example of CURL:```bashcurl --location 'https://api.intercom.io/conversations' \--header 'Authorization: Bearer <admin_token>' \--header 'Content-Type: application/json' \--header 'Intercom-Version: 2.10' \--data '{    "from": {        "type": "user",        "id": "<contact_id>"    },    "subject": "Test Subject",    "attachment_urls": [        "https://picsum.photos/seed/picsum/512/512"    ]}'```The example of response:```JSON{    "type": "error.list",    "request_id": "0035jabkv5b82qmiu3cg",

I am trying to fetch 150  contacts per page while calling  https://api.intercom.io/contacts.but on trying to do so , i am getting the following error {"type":"error.list","request_id":"0069rm2ubh0lgdfr7kg0","errors":[{"code":"invalid_document","message":"either_email_or_user_id_present validation failed"}]} attaching the REST API INTEGRTION code below: ( implemented using Salesforce Apex) String endpoint=’ https://api.intercom.io/contacts’HttpRequest request = new HttpRequest(); request.setEndpoint(endpoint); request.setMethod('GET'); request.setHeader('Authorization', 'Bearer ' + INTERCOM_API_TOKEN); request.setHeader('Accept', 'application/json'); request.setHeader('Content-Type','application/Json');

i am trying to delete contact with API and it keeps giving me error "errors":[{"code":"not_found","message":"User Not Found"}] , i double checked about the id i am passing and it is correct. i also check for this error code but didn't find anything in the documentation

The JS API call is not working for me → Intercom('showArticle', articleId) I am using some othe JSAPI calls on the same page which are wirking.Are there any known issues?  

Hi there,I am trying to leverage the messages endpoint (https://api.intercom.io/messages and send an email using Intercom, with the template 'plain'. However, it seems like the 'message_type' body parameter is not working, since I send it and it generates an in-app message instead of an email. Here is the body of my request:{ "message_type": "email", "subject": "Hey", "body": "test", "template": "plain", "from": { "type": "user", "id": "63db09ccde07bab99d849eb0" }, "to": { "type": "user", "id": "630e7f6692c1ab99a7ef98af" } }And here is the response I am getting:{ "type": "user_message", "id": "1585218670", "cre

I set up a webhook when a conversation is assigned to an admin (conversation.admin.assigned). It works fine and is triggered correctly when the assignment is done manually, but it is not triggered at all when it is done through inbox rules. Is this expected?

Hi, Im currently collecting customer satisfaction by querying all the individual conversations and making the calculation myself. It would be nice if there was direct access to pull the customer satisfaction report, but besides that the issue with pulling individual conversations is that if a users account is deleted their conversation is too, preventing me from getting perfectly accurate results. The question is, whats the best way for me to pull customer satisfaction then if i cant rely on pulling individual conversations? 

As an example, I want to search for all tickets which have the text “high priority” in the title (The words must appear together in the title)I am unable to figure out how to do this.

Hello,I’ve been successfully using the Intercom API to tag multiple contacts at once using the /tags endpoint. However, I’m now facing a challenge: I need to remove tags from multiple contacts, but I can’t find a straightforward solution in the documentation.Here’s the snippet I’ve been using to tag contacts:const resp = await fetch( `https://api.intercom.io/tags`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Intercom-Version': '2.10', Authorization: 'Bearer <YOUR_TOKEN_HERE>' }, body: JSON.stringify({name: 'test', users: [{ id: 'userId1' }, { id: 'userId2' }] }) } );https://developers.intercom.com/docs/re

Intercom(‘trackEvent’, ‘myevent’).on(‘fired’, function () {  // The event has fired.}).on(‘unscheduled’, function () {  // The event rules met but unable to fire based on schedule.});See example above: Is there a way to track an event not firing based on not being scheduled but meeting the rules? (meeting rules but not in schedule to be fired)The reason being that I’m working with javascript where there would need to be default behavior if the Intercom banner doesn’t show.intercom banner → close banner → redirect to url (no banner) → redirect to url

I’m trying to create a conversation with https://api.intercom.io/conversations REQUST BODY:{    "from": {        "type": "contact",        "user_id": "123456789"    },    "body": "Hello"},HEADER PARAMETERS:Intercom-Version: 2.10Authorization: Bearer <access_token> RESPONSE:{    "type": "error.list",    "request_id": "0002sf5fchfdlt2eus20",    "errors": [        {            "code": "not_found",            "message": "User Not Found"        }    ]} Could I be missing something? 

Hello Intercom Community,I am currently designing an ETL job to ingest daily customer conversation data from Intercom and have a specific question regarding the merging of lead and user profiles, as documented here: Merge Lead and User Profiles.When a lead profile is merged with a user profile and the lead's conversations are transferred to the user's profile, how is this process implemented in the background regarding the conversation_id and the intercom_id of the transferred conversation? Specifically, are the conversations from the lead profile:Copied as new conversations with new conversation IDs [conversation_id], but now associated with the user's Intercom ID [intercom_id]? Or is the existing conversation (originally under the lead's profile) simply updated to r

Hello,I trying to search by using the “POST /contacts/search” API. If I call the API from either POSTMAN or form the JSON as string, everything works fine. But when I trying to serialize an object to JSON and call the API, I get the error “Query body must contain a query hash”.This is from .NET API.Scenario which worksvar json = JObject.Parse($@"{{    ""query"": {{        ""operator"": ""AND"",        ""value"": [            {{                ""field"": ""email"",                ""operator"": ""="",                ""value"": ""{email}""            }}        ]    }}}}");var jsonStr = json.ToString();var postData = new StringContent(jsonStr, Encoding.UTF8, "application/json");using (HttpResponseMessage response = await httpClient.PostAsync($"/contacts/search", postData)){ … }Scen

Hello, I’ve successfully subscribed my url to the conversation.rating.added topic, and I’m getting the data.However, I’ve noticed that the conversation_rating object which is supposed to contain the “rating” and “remark” is always null.How can I get the “rating” and “remark” directly from the webhook each time a rating is added to a conversation? Thanks!

We do have our app published in intercom store and our customers gonna use that app to install / use it to interact with our system, we do ask customers to configure the our endpoint under webhook for interaction purpose. I do have questions, as per this documentation https://developers.intercom.com/docs/references/webhooks/webhook-models/#signed-notifications they mentioned “your app’s client secret” do that mean client secret of published app or we should get customer’s intercom workspace app’s client secret