API & Webhooks

there is a problem executing query on contacts resource search, there is no problem with version, I’ve checked them few times, contacts resource seach gives me “Bad Request”any solution what can be a problem ?I’m using php sdk for intercom, project is written in laravel. everything is working fine on version 1.0, REST api calls are working fine when I’m defining intercom api version manually.

Hello everyone,I'm working on a project that requires exporting/fetching millions of records from Intercom using the API. I've tried using the existing endpoints for exporting data, such as /users or /companies, but the response time is extremely slow and it times out before all the data can be retrieved.I've also looked into the pagination and rate limits set by the API, but I'm still having trouble exporting large amounts of data efficiently. Ideally, I'd like to be able to fetch the data in bulk and avoid hitting the rate limits.Has anyone else encountered this issue and found a solution for exporting large amounts of data from Intercom via the API? Are there any best practices or third-party tools that can be used for this purpose?I'd appreciate any insights or advice on how to handle this. Thank you!🙏

As the title says, is it possible to update a Company Attribute with a Custom Action?I tried below, but I'm not sure how to get the unique identifier for the company.  

Hello, Intercom 🤗There are cases when no information regarding ratelimit is returned in response headers. Is there an explanation or can it be considered a bug?Here is an example of such a response ⬇️[date] => Mon, 06 Mar 2023 10:08:33 GMT    [content-type] => application/json; charset=utf-8    [status] => 200 OK    [vary] => Accept,Accept-Encoding    [x-intercom-version] => 7fc0c384b3b84daca9bd5e3f87f3e6bb3e3338d9    [x-request-id] => 00400fvdf2njmt9srsjg It can happen from time to time, without any clear pattern. Also it can happen with any of API calls.

Are there Typescript definitions somewhere of the webhook payloads? Thank you!

I was able to use the NPM “intercom-client” successfully to dataExport a day (as a sample). But I failed to download it.First, I can’t find a way to use the NPM to download the file.Second, trying the job identifier in the documentation and from a normal Axios call throw this error:So in my axios call I added the needed headers as below - I used the dataExport.find to get the download URL:But when the file is downloaded, I get the below: 

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 after (e.g. because of a network issue). Thus the first lead is not yet returned by the API (delayed) and a new one created.The net

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?