What are Webhooks?

Webhooks are a streamlined way for your Intercom App to respond to events happening in Intercom. To get started, you'll need to create an Intercom App and provide us with a URL to send notifications to. When an event occurs, Intercom will send a notification to the URL you have configured for your Webhook. You can then use this notification to trigger actions in your App.

If you're new to Webhooks more generally, head to pipedream's RequestBin blog to learn more.

The main concepts of Intercom Webhooks are subscriptions, topics and notifications.

Subscriptions

A Webhook Subscription is created within an App and is where you define the Topics you want to receive event Notifications on. A subscription can contain one or more topics. You will need to provide a URL where Intercom will send all notifications for your subscription.

Topics

A topic contains the events you will receive notifications on; for example, Conversation created or Contact deleted.

A subscription will contain one or more topics. Topics are types of notifications that you want to be informed about.

Notifications

A notification is the event object delivered when an event is triggered, and notifications have data payloads that contain references to the Intercom objects associated with the event. Notifications for all topics will be sent to the URL you provided for your subscription.

If more of a visual person, here's a diagram of the Webhook system:

Intercom Webhook Diagram

What's next?

Now that you've learned the basics of webhooks, you could: