Linking Intercom as a source

The Intercom connector syncs your Intercom workspace data into PostHog, including contacts, conversations, companies, tickets, activity logs, and more.

Adding a data source

  1. Go to the Data pipeline page and the Sources tab in PostHog.
  2. Click + New source and select Intercom.
  3. Select the Intercom workspace you want to link and click Connect.
  4. Optional: Add a prefix to your table names.
  5. Select the tables you want to import.
  6. Click Import.

The data warehouse then starts syncing your Intercom data. You can see details, progress, and rows synced in the data pipeline sources tab.

Available tables

TableSync modeDescription
adminsFull refreshWorkspace admins
teamsFull refreshTeams
tagsFull refreshTags
segmentsFull refreshCustomer segments
companiesFull refreshCompanies
company_segmentsFull refreshSegments associated with each company
articlesFull refreshHelp center articles
company_attributesFull refreshCustom company-level data attributes
contact_attributesFull refreshCustom contact-level data attributes
contactsIncremental (updated_at)Contacts and leads
conversationsIncremental (updated_at)Customer conversations
ticketsIncremental (updated_at)Support tickets
activity_logsIncremental (created_at)Admin activity logs
conversation_partsIncremental (updated_at via parent)Individual messages within conversations

Sync modes

Intercom tables support both full refresh and incremental syncing depending on the table:

  • Full refresh – Re-imports all records from Intercom on every sync. Used for tables where Intercom's API doesn't support server-side filtering by timestamp (admins, teams, tags, segments, companies, company_segments, articles, company_attributes, contact_attributes).

  • Incremental – Only imports records modified since the last sync. Available for contacts, conversations, tickets, activity_logs, and conversation_parts. These tables use a server-side updated_at or created_at filter, so only changed data is fetched.

When you enable incremental sync for a supported table:

  1. The first sync performs a full import to establish a baseline.
  2. Subsequent syncs only fetch records modified since the last sync.

Configuration

OptionTypeRequired
Intercom workspaceoauthYes

Community questions

Was this page useful?

Questions about this page? or post a community question.