> ## Documentation Index
> Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercom source for ELT & CDC

> Configure Intercom as a data source in Integrate.io ELT & CDC. Replicate contacts, conversations, tickets, and companies to your data warehouse.

|                           |                                                                                          |
| :------------------------ | :--------------------------------------------------------------------------------------- |
| **Description**           | ***Intercom*** is a customer messaging platform for sales, marketing, and support teams. |
| **Supported Replication** | Initial Sync, Continuous Sync                                                            |
| **Authentication Type**   | OAuth                                                                                    |

## Collections

| **Collection Name** | **Full/**   **Initial Sync** | **Incremental/**   **Continuous Sync** | **Supports Update** | **Supports Delete** |
| :------------------ | :--------------------------- | :------------------------------------- | :------------------ | :------------------ |
| Contacts            | ✔                            | ✔                                      | ✔                   |                     |
| Companies           | ✔                            | ✖                                      |                     |                     |
| Conversations       | ✔                            | ✔                                      | ✔                   |                     |
| Conversation Parts  | ✔                            | ✔                                      | ✔                   |                     |
| Tickets             | ✔                            | ✔                                      | ✔                   |                     |
| Admins              | ✔                            | ✖                                      |                     |                     |
| Teams               | ✔                            | ✖                                      |                     |                     |
| Tags                | ✔                            | ✖                                      |                     |                     |
| Segments            | ✔                            | ✖                                      |                     |                     |
| Data Attributes     | ✔                            | ✖                                      |                     |                     |
| Articles            | ✔                            | ✖                                      |                     |                     |

## Setting up Intercom for ELT & CDC

### Overview

ELT & CDC uses the API provided by Intercom to sync the data. [Intercom API Reference](https://developers.intercom.com/docs/references/rest-api)

### Requirements

* You need to authenticate via OAuth2.
* Click the Authenticate button on the dashboard, sign in to Intercom, and grant access to Integrate.io.

### Sync modes

Streams that expose a server-side `updated_at` filter through the Intercom Search API run in Continuous Sync: `Contacts`, `Conversations`, `Tickets`, and `Conversation Parts` (which rides the incremental `Conversations` stream). `Companies` uses the Intercom Scroll API and the reference collections (`Admins`, `Teams`, `Tags`, `Segments`, `Data Attributes`, `Articles`) run as full-refresh on each sync because their list endpoints do not expose an `updated_at` filter.

### Notes

* `Data Attributes` uses a composite primary key of `(model, full_name)` because standard Intercom attributes have a null `id`.
