Intercom Connector

Last updated: Oct 07, 2022

With the Intercom Connector, you can send event data from PostHog to Intercom whenever an event matches a user who has been identified by their email address.

What are the requirements for this app?

Using this app requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later.

Not running 1.30.0? Find out how to update your self-hosted PostHog deployment!

Installation

Visit the 'Apps' page in your instance of PostHog.
Search for 'Intercom' and select the app, press 'Install'.
Follow the steps below to configure the app.

Important: Only events that have an email property will be sent to Intercom. For more information on how to configure this, take a look at this section.

Configuration

After you've pressed 'Install', you need to add your Intercom API key at the configuration step, as well as add triggering events you want to send to Intercom.

Intercom API Key (required): you can get this one from the Intercom Developer Hub, by creating a new app and receiving an API Key
Triggering events (required): A comma-separated list of PostHog events you want to send to Intercom (e.g.: $identify,mycustomevent ).

Additional configuration

Option	Description
`Intercom API Key` Type: string Required: True	Create an Intercom app, then go to Configure > Authentication to find your key.
`Triggering events` Type: string Required: True	A comma-separated list of PostHog events you want to send to Intercom (e.g.: '$identify,mycustomevent' ).
`Email domains to skip` Type: string Required: False	A comma-separated list of email domains to ignore and not send events for in Intercom (e.g. 'posthog.com,dev.posthog.com' ).
`Send events to European Data Hosting` Type: choice Required: False	Send events to api.eu.intercom.com, if you are using Intercom's European Data Hosting.

Setting up tracking

In order for your events to show up in Intercom, they need to have an email property so we know which user to connect them to. The easiest way to do this is with Super Properties, which will add an email property on every event.

Add the following code wherever you make an identify call with the current user's email address.

JavaScript

posthog.register({
    email: 'hello@posthog.com'
})

This will then send this as a property on all future events, including autocaptured events.

Note: Make sure to call posthog.unregister('email') whenever a user logs out to clear this property

Currently, Super Properties are only available in the posthog-js library or when using the PostHog snippet. If you are using a different SDK, you'll need to manually the email property for every event that you want to send to Intercom.

Further information

Who created this app?

We'd like to thank PostHog team member Emanuele Capparelli for his work creating this app. Thank you, Emanuele!

Who maintains this app?

This app is maintained by the community. If you have issues with the app not functioning as intended, please raise a bug report to let us know!

What if I have feedback on this app?

We love feature requests and feedback! Please create an issue to tell us what you think.

What if my question isn't answered above?

We love answering questions. Ask us anything via our Support page.

You can also join the PostHog Community Slack group to collaborate with others and get advice on developing your own PostHog apps.

Questions?

Was this page useful?

Migrator 3000

What does the Migrator 3000 app do? The Migrator app enables you to move events from one PostHog instance to another, so that you can move from a self-hosted instance to a PostHog Cloud deployment, or vice versa. Does the Migrator 3000 app move all content to the new instance? No, this app will only migrate events and objects derived from events, such as persons. Dashboards, Insights, Feature Flags, etc. will not be migrated and must be manually recreated on the new instance. What are the…