DocsBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Topics

The following topics and sub-topics can be subscribed to. The 'Item Type' column shows the API type that will be sent as the data of the Notification (for more information on API types, see "API Summary" in the Intercom API documentation.

Topic

Item Type

Description

conversation.user.created

Conversation

Subscribe to user and lead initiated messages

conversation.user.replied

Conversation

Subscribe to user conversation replies

conversation.admin.replied

Conversation

Subscribe to admin conversation replies

conversation.admin.single.created

Conversation

Subscribe to admin initiated 1:1 conversation

conversation.admin.assigned

Conversation

Subscribe to admin conversation assignments

conversation.admin.noted

Conversation

Subscribe to admin conversation notes

conversation.admin.closed

Conversation

Subscribe to admin conversation closes

conversation.admin.opened

Conversation

Subscribe to admin conversation opens

conversation_part.tag.created

Conversation

Subscribe to conversation parts being tagged

user.created

User

Subscribe to user creations

user.deleted

User

Subscribe to users being archived. Not sent for bulk archiving.

user.unsubscribed

User

Subscribe to user unsubscriptions from email

user.email.updated

User

Subscribe to user's email address being updated

user.tag.created

UserTag

Subscribe to users being tagged. Not sent for bulk tagging.

user.tag.deleted

UserTag

Subscribe to users being untagged

contact.created

Lead

Subscribe to Lead creations

contact.signed_up

Lead

Subscribe to Leads converting to a User

contact.added_email

Lead

Subscribe to Leads adding email

visitor.signed_up

Visitor

Subscribe to visitors converting to a User

company.created

Company

Subscribe to company creations

event.created

Event

Subscribe to events (Beta!)

ping

Ping

Sent when a post to the Subscription's ping resource is received, or periodically by Intercom. Ping is always subscribed to.

  • The UserTag object is specific to webhooks - see "User Tag Object" for a description.
  • On the Intercom site, bulk user tagging operations do not trigger webhooks and only single user tag operations will result in a webhook being sent.