Webhooks are a powerful resource that you can use to automate your use cases and improve your productivity.

Unlike the API resources, which represent static data that you can create, update and retrieve as needed, webhooks represent dynamic resources. You can configure them to automatically notify you when a customer has taken a particular action, such as making a purchase or replying to a conversation.

If you're new to webhooks, consider reading a guide such as this to learn more.

The main concepts for the Webhooks are subscriptions, topics, and notifications.


A subscription is where you select a topic you wanted to be notified about. Intercom will setup subscriptions for selected topics when that app is installed on a workspace.


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


The object delivered to a webhook is a notification. Notifications have payloads, which contain the API’s existing JSON objects, such as user or conversations. You will need to provide a URL where Intercom will send these request.

What's Next

Make sure you understand how to setup, update, and remove webhooks with the Setting up Webhooks guide. Take a look at the different topics available, their related permissions, and example notifications on the Webhook Models page. For any unanswered questions, go to the FAQ page which covers concepts more in-depth.

Setting up Webhooks
Webhook Models
Webhooks FAQ


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.