API & Webhooks

Hi all - am trying to find documentation for our dev team that give the specific instructions on how to setup custom event tracking so that we pick up the first time someone does something. For instance, sending an email when the customer clicks 'Create Account' which they will only do once. I need to provide the exact steps required from a dev perspective and most of the documentation I've come across is still quite ambiguous. Any insights much appreciated.  Cheers! Emily

I'm posting this as a new question, because my previous one is 7 days old and had no reply:This job ID: azzldhejyd7n7mjd When trying to retrieve the data immediately, it works. After some time however (tested 10h30 later), it gave 500 internal server error.I have this with every export: after a larger amount of time, it results in an error 500.According to the documentation, this data should remain available at least 2 days.This is all via the intercom API.Thanks

I want to embed the Intercom widget which is within Kissflow's User Interface to our 3rd party community platform.

I verified the attribute exists using the /data_attributes endpoint, but when I send a POST request to /conversations/search, I get: {'type': 'error.list', 'request_id': '001ked9vudjnmtu2fm40', 'errors': [{'code': 'invalid_field', 'message': 'custom_attributes.Details is not a valid search field'}]} I am able to filter on built-in values, like "created_at" etc OK so the code works but the search query using custom_attributes, doesn't.  Anyone else have this same problem?

First, I create a job using https://api.intercom.io/export/content/data/p>I receive a job ID.If I retrieve the data as soon as it's available, there's no problem. (retrieving the data is using https://api.intercom.io/download/content/data/my_job_id. However 24h later, the job identifier doesn't work anymore. I get back an internal server error (500). The documentation says data should remain available for download for much longer (several days). Also I didn't launch a different job in the meantime, so I don't understand why the data retrieval is broken.

Is there an API endpoint that allows the creation of multiple contacts with one call, or does each individual contact creation requires an individual API call?

The way the Intercom API currently works makes it complicated to reliably create and update contacts. Example 1: Newsletter sign-upList all contacts with that email address.Update existing contact or create new one as needed:If there is a user then update that user.Otherwise if there is a lead then update that lead.Otherwise create a new lead.If an existing contact was updated then also remove an eventual subscription opt-out and "unsubscribe all" flag for that contact. Step 2 can create duplicate leads if, for example:A user was created very recently before the newsletter sign-up (e.g. user created by product sign-up and then they sign up for the newsletter shortly after). Thus the user is not yet returned by the API (delayed) and a new lead created.A lead was created very recently for the newsletter sign-up but the person signs up again shortly

We have 3 custom qualification data fields that got created when we first initialized a session using them a long time ago. These field values are being filled in through a cookie.  Yesterday everything seemed to be working okay but now only 1 of the fields (userID) is getting populated with a value but it is not consistent either. Our developer has been unable to determine the cause of the issue between yesterday and today. The only "significant" change was we renewed our contract and we ended up getting rid of the Advanced Workspace Management since we did not use most of the features with that add-on.  How do we get support on this?

According to the documentation I can only filter and get data from the first page or get all data without filter.But, for example, I made a I posted the request at https://api.intercom.io/contacts/searchand it returned me that I have 8 pages with 50 contacts each, and that they were created with a certain date. But I can only access the data from page 1.So I tried to use the post request to https://api.intercom.io/contacts?per_page=150to be able to reproduce the json that you demonstrate in https://developers.intercom.com/intercom-api-reference/reference/ -cursor paging. But instead of the 8 filtered pages it goes to 62 unfiltered pages.

Hej, currently we are using the intercom-client v.2.10.4 to create a new contact with the role 'user'.In the version 4.0.0 the API has changed but I cannot create a user with the call 'client.contacts.createUser'.How can I migrate our project so, I can use the latest version of the intercom client?

Is it possible to open the Articles Help Center through the Javascript API? I see there are mobile options (ex: https://developers.intercom.com/installing-intercom/docs/react-native-help-center but can't find any documentation for a web option.

What is the current API rate limit?

Can I use the API to create my own workarounds?

Is it possible to reassign conversations which haven't received a reply after a period of time via the API?

I'm wondering if I can assign a visitor an email address via API?

Currently, I am working with a client have million of records(contact, conversation, team, admins etc and they want to export these records to a remote Database where they want to consume the data on their own way. So I am fetching the records using the API and it has a limit of max page size 150. If we want to export around 4.3M records then it will required around 28667 https calls and a huge amount of time. So is there any way to increase the page size or fetch the records in bulk using the API ?

There's no mention in the docs how is pagination supported. Trying to add query params per_page and/or page has no effect on the response. I would expect it to affect the page size and the page of results that is returned.Notice that in /conversations, paging works with ?start_after query parameter and this is no in accordance with the API doc.

Is there any way to remove users/people from companies people list. I know that we can do it manually but there are many companies that we want to edit all at once with an api endpoint like https://api.intercom.io/companies/:id/members/:user_id/p> 

It would be nice to be able to create tickets through the api. For example, we need to create a ticket for the sales team in intercom when a user registers in our system. How could this be implemented?

How do I get the specific author ID for Articles API?

Would be great to develop some apps for this feature 🤙

With the API or from the UI, I can create custom data attributes. These attributes can have one of string, integer, float, boolean, or date values. However, I need to store a list of values in a field.  For example, a user (contact) can be in many teams at once in our system. But with the above model, I can only have one team at a time.  What are the possible ways to implement the above functionality with the API/SDK? Should I use tags, or something else? Thanks in advance.

I would like to get latest conversation , people name for set of company id's I have offline.Is it possible to do by retriving conversations of a particular company as a first step​. Then retrieve people name from it

Let's say we have a financial services platform (as an example, we don't). Let's say that platform uses Intercom and let's say our company wants to generate a message to all of our users when a certain event occurs. That's the broad use case. An example would be ABC stock just hit $100/share.  This "outside" event occurs, and maybe a notification is sent outside of intercom (via email, or other ways). Is it possible for intercom to "listen" for this outside event, and when it is heard, to take action by generating an in-app message to the end user via messenger? Essentially, an event happens on platform A (stock hits $100 and triggers a message) and we want users of platform B (intercom) to receive a message about it in their messenger inbox.

Hi,My colleague asked me (amongst other things) for a programmatic export of "email opens" from Intercom, on an individual contact level.What would be the best way to accomplish this?I've looked into the API endpoints, but the "messages" endpoint has no documentation and other endpoints aren't very suited for 'bulk' exports. I've also looked into the 'export' endpoint, which allows me to do a bulk export, BUT only emails sent within the selected time window are included in the 'receipts', and if a user opened/clicked after the time window this is not in the report, and the time window is limited to 90 days.The combination of this makes it very hard to export a complete overview of (for example) email opens on an individual level. I hope there's a good solution that suits our needs.Kind regards