Intercom Integration

In this article, we will integrate an Intercom data source with Y42.

On our platform you can configure your Intercom integration to query several schemas of data from different streams. 
You can find more information on the endpoints directly in the Intercom API documentation.


Authentication: API Key authentication
Settings: Historical Date selection
Schema type: Fixed & Dynamic
Update Type: Full import and incremental


Application credentials are strongly generated username:password combinations and have a one-to-one binding with a membership in the consortia. They are strictly isolated to the environment in which they are created and can only be used to access a node/service owned by the same membership that created the credentials.
For this connection, Intercom supports API Key authentication. You can find your Access Token in Configure > Authentication section in your app within the Developer Hub.

Import Settings

By default the historical date will be set to one year ago. Refer to your own datasource to decide from which exact date you would want to retrieve data.


Most of the schemas for the Intercom integration are static except for the streams which have custom fields. Custom fields are retrieved dynamically during discovery. 

Updating your data

You have the option of scheduling Full imports or Incremental Imports by the month, weeks, days, and even by the hour. With the incremental import you will only add the new rows to that table, while a full import will actually re-import the entire table completely.

Incremental imports significantly increase the import speed, we import your table incrementally based on the last imported state e.g. id - If the table does not have a state, a full import will be triggered - This is done automatically.


Custom fields

Only Contacts and Company tables support the custom fields. They are retrieved dynamically during discovery of the schema.

Rate Limits

Intercom has a default rate limit of 1000 API calls per minute. Even if we hit this limit, the retry logic will retry the request.


Intercom Setup Guide:

  1. On Integrate, click on "Add..." to search for Intercom and select it.

  2. Name your integration.

  3. Paste your API Key and click Connect.

  4. After connecting, you are good to go and start importing your tables.

  5. Choose from which point onwards in time to import your data.

  6. Select the tables you need and click import. You can start accessing the tables once the status is “Ready”. 

Note: You can always import and reimport other tables as well, or delete them.

Was this article helpful?
0 out of 0 found this helpful