API ReferenceBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Webhooks

Overview

Webhooks allow you to subscribe to real-time notifications of events happening in Intercom, a Contact created, an incoming Conversation received, or an Admin Away Mode updated.

If you're unfamiliar with Webhooks, 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.

Webhooks FAQs

Do Webhooks belong to my Workspace or my App?

Webhooks are associated with an App, and you configure your Webhooks per App just like you configure your Access Tokens. When you configure a Webhook, you tell Intercom where you want Notifications sent for one or more Topics.

If I am developing Apps for other people, what do I need to do?

You will need to select the correct permissions on the Authorization page of your App and then subscribe to the relevant topics on the Webhooks page.

Can I set up Subscriptions for Webhook Topics via the API?

No, you can only subscribe to Webhooks via Apps in your Developer Hub.

I previously configured webhooks via the API. Can I still do that?

If you previously set up Workspace Webhooks via the API, these will continue to work, and Intercom will not delete or reconfigure them.

What IP addresses does Intercom send Webhook Notifications from?

The IP addresses Intercom sends Webhook Notifications from are:

USA
34.231.68.152
34.197.76.213
35.171.78.91
35.169.138.21
52.70.27.159
52.44.63.161

Europe
54.217.125.63
54.246.173.113
54.216.9.3

Australia
52.63.36.185
3.104.68.152
52.64.2.165