API & Webhooks | Community
Skip to main content

API & Webhooks

Get more out of Intercom using our API and webhooks

  • 553 Topics
  • 1,268 Replies
553 Topics
G
gever2297New Participant
asked in API & Webhooks
Contacts resource search bad request

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.

722
G
U
User1417New Participant
asked in API & Webhooks
Strategies for Fetching Massive Amounts of Data from Intercom via API

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!🙏

1721
S
Innovator ✨
R
Rodney ZNew Participant
asked in API & Webhooks
Update Company Attribute with Custom Action

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.  

1151
Racheal
Intercom Team
А
Александр ШубинNew Participant
asked in API & Webhooks
Missing ratelimit in headers

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.

561
Racheal
Intercom Team
U
UserOpenDogNew Participant
asked in API & Webhooks
Typescript definition for the webhook payloads

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

1673
Racheal
Intercom Team
B
Bassam TantawiNew Participant
asked in API & Webhooks
Trying to download CSV Failed "The requested resource does not exist; check your path and try again"

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: 

2032
B
E
Emily FNew Participant
posted in API & Webhooks
How do we technically implement custom event tracking so that we can track the first time a user does something (i.e. clicks a button) (Cordova)

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

960
E
B
Bruno DNew Participant
asked in API & Webhooks
API: export job returns error 500 after a few hours

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

2720
B
N
NandiniActive User
posted in API & Webhooks
I want to embed the Intercom widget which is within Kissflow's User Interface to our 3rd party community platform.

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

170
N
C
Chris K14Connector
asked in API & Webhooks
Unable to search conversations using a custom_attribute.

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?

4090
Daniel M15
Employee
B
Bruno DNew Participant
asked in API & Webhooks
I'm trying to download a report from the API. I retrieve the data after 24 h which gives me a "500 server error", although the documentation says data is available for several days and I don't launch another job in the meantime.

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.

1110
B
G
Goran KNew Participant
asked in API & Webhooks
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?

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?

240
Joseph S.
Expert User ✨
M
Marc K12New Participant
asked in API & Webhooks
API should return updated data in real-time & simplify updates

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

4400
A
B
Brent LNew Participant
asked in API & Webhooks
Custom attribute qualification data fields are no longer being filled by cookies.

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?

440
P
Employee
U
User1631New Participant
asked in API & Webhooks
How can I filter the contacts created after a certain date and, if I have more than one page, scroll through them?

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.

1210
U
U
User1622New Participant
asked in API & Webhooks
How to migrate API from v.2.10.4 to 4.0.0

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?

720
U
M
MorganneNew Participant
asked in API & Webhooks
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.

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.

850
A
L
Lisa B13New Participant
asked in API & Webhooks
What is the current API rate limit?

What is the current API rate limit?

17790
L
Employee
L
Lisa B13New Participant
asked in API & Webhooks
Can I use the API to create my own workarounds?

Can I use the API to create my own workarounds?

260
L
Employee
L
Lisa B13New Participant
asked in API & Webhooks
Is it possible to reassign conversations which haven't received a reply after a period of time via the API?

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

1410
L
Employee
L
Lisa B13New Participant
asked in API & Webhooks
I'm wondering if I can assign a visitor an email address via API?

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

900
L
Employee
M
Manish KNew Participant
asked in API & Webhooks
How to export/fetch million of records in bulk using 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 ?

670
Joseph S.
Expert User ✨
R
Ron SNew Participant
asked in API & Webhooks
How is pagination supported in conversations/search

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.

1000
Joseph S.
Expert User ✨
S
Sam LNew Participant
asked in API & Webhooks
Is there any way to remove users from companies people list?

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> 

530
Racheal
Intercom Team
K
KirNew Participant
asked in API & Webhooks
It would be nice to be able to create tickets through the api.

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?

410
Racheal
Intercom Team
Ask a question
Terms & Conditions