Intercom Webhook Setup Guide

When linking your Intercom account in StackOne (or via StackOne Hub), the Native Webhook URL is displayed on the hub form. Copy this URL — you will paste it into the Intercom Developer Hub in the next steps.

Navigate to the Developer Hub using the same steps from the authentication setup.

• Click Settings in the bottom-left corner of the Intercom dashboard.
• Navigate to Integrations in the menu.
• Click on Developer Hub.
• Click on your existing app (e.g., “StackOne Integration”).

In the left sidebar of your app, under Configure, click Webhooks.

Paste the Native Webhook URL (copied from StackOne) into the Endpoint URL field. This is where Intercom will POST all webhook events.

Under Topics, use the Select a topic… dropdown to add the events you want to receive. Each topic corresponds to a specific event type (e.g., contact.user.created, company.created, conversation.admin.replied).

• Select each topic you want to subscribe to from the dropdown.
• Enabled topics will appear in the table with an On status.
• Ensure the required Permissions are granted for each topic (shown in the Permissions column).
• See the Available Webhook Events section below for the full list of supported topics.

Click the Save button in the top-right corner to save the webhook configuration.

To stop receiving specific events, remove the topic from the Topics list in the Developer Hub and save. To stop all events, clear the Endpoint URL field or delete the app.

Events related to company records.

• Company Created (company.created) — Fired when a new company is created
• Company Updated (company.updated) — Fired when a company record is updated
• Company Deleted (company.deleted) — Fired when a company is deleted
• Company Contact Attached (company.contact.attached) — Fired when a contact is attached to a company
• Company Contact Detached (company.contact.detached) — Fired when a contact is detached from a company

Events related to contacts (users and leads).

• Contact Archived (contact.archived) — Fired when a contact is archived
• Contact Deleted (contact.deleted) — Fired when a contact is deleted
• Contact Unarchived (contact.unarchive) — Fired when a contact is restored from archive
• Contact Email Updated (contact.email.updated) — Fired when a contact’s email changes
• Contact Merged (contact.merged) — Fired when two contacts are merged
• Contact Subscribed (contact.subscribed) — Fired when a contact subscribes to email
• Contact Unsubscribed (contact.unsubscribed) — Fired when a contact unsubscribes from email
• Lead Created (contact.lead.created) — Fired when a new lead is created
• Lead Updated (contact.lead.updated) — Fired when a lead is updated
• Lead Tag Created (contact.lead.tag.created) — Fired when a tag is applied to a lead
• Lead Tag Deleted (contact.lead.tag.deleted) — Fired when a tag is removed from a lead
• User Created (contact.user.created) — Fired when a new user is created
• User Updated (contact.user.updated) — Fired when a user is updated
• User Tag Created (contact.user.tag.created) — Fired when a tag is applied to a user
• User Tag Deleted (contact.user.tag.deleted) — Fired when a tag is removed from a user

Events related to conversations.

• Admin Assigned (conversation.admin.assigned) — Fired when a conversation is assigned to a teammate
• Admin Closed (conversation.admin.closed) — Fired when a conversation is closed
• Admin Noted (conversation.admin.noted) — Fired when a note is added to a conversation
• Admin Opened (conversation.admin.opened) — Fired when a conversation is reopened
• Admin Replied (conversation.admin.replied) — Fired when a teammate replies
• Admin Single Created (conversation.admin.single.created) — Fired when an admin initiates a message to one user
• Admin Snoozed (conversation.admin.snoozed) — Fired when a conversation is snoozed
• Admin Unsnoozed (conversation.admin.unsnoozed) — Fired when a conversation is unsnoozed
• Contact Attached (conversation.contact.attached) — Fired when a contact is added to a conversation
• Contact Detached (conversation.contact.detached) — Fired when a contact is removed from a conversation
• Conversation Deleted (conversation.deleted) — Fired when a conversation is deleted

Events related to tickets.

• Ticket Created (ticket.created) — Fired when a new ticket is created
• Ticket State Updated (ticket.state.updated) — Fired when a ticket’s state changes
• Ticket Note Created (ticket.note.created) — Fired when a note is added to a ticket
• Ticket Admin Assigned (ticket.admin.assigned) — Fired when a ticket is assigned to an admin
• Ticket Admin Replied (ticket.admin.replied) — Fired when an admin replies to a ticket
• Ticket Attribute Updated (ticket.attribute.updated) — Fired when a ticket attribute is modified
• Ticket Contact Attached (ticket.contact.attached) — Fired when a contact is added to a ticket
• Ticket Closed (ticket.closed) — Fired when a ticket is closed
• Ticket Resolved (ticket.resolved) — Fired when a ticket is resolved

Events related to help center articles.

• Article Created (article.created) — Fired when a new article is created
• Article Updated (article.updated) — Fired when an article is modified
• Article Published (article.published) — Fired when an article is published
• Article Unpublished (article.unpublished) — Fired when an article is unpublished
• Article Deleted (article.deleted) — Fired when an article is deleted