Single subscriber endpoint that receives every Intercom notification event
the app is subscribed to. The `topic` field on the JSON envelope identifies
the event class. Intercom sends one notification per HTTP POST and expects
a 2xx response; non-2xx responses are retried with exponential backoff
until `delivery_attempts` is exhausted.
Sent when an admin manually pings the subscription or Intercom periodically validates it.
Content-Type: application/json
AdminAddedToWorkspaceNotification
A new admin (teammate) joined the workspace.
Content-Type: application/json
AdminAwayModeUpdatedNotification
An admin toggled away mode or updated their reassignment setting.
Content-Type: application/json
AdminActivityLogEventCreatedNotification
An admin activity log entry was created.
Content-Type: application/json
AdminRemovedFromWorkspaceNotification
An admin (teammate) was removed from the workspace.
Content-Type: application/json
AdminLoggedInNotification
An admin signed in to the workspace.
Content-Type: application/json
AdminLoggedOutNotification
An admin signed out of the workspace.
Content-Type: application/json
ArticleCreatedNotification
A help center article was created.
Content-Type: application/json
ArticleUpdatedNotification
A help center article was updated.
Content-Type: application/json
ArticlePublishedNotification
A help center article was published.
Content-Type: application/json
ArticleUnpublishedNotification
A help center article was unpublished.
Content-Type: application/json
ArticleDeletedNotification
A help center article was deleted.
Content-Type: application/json
CompanyCreatedNotification
A new company was created in the workspace.
Content-Type: application/json
CompanyUpdatedNotification
A company's attributes were updated.
Content-Type: application/json
CompanyDeletedNotification
A company was deleted.
Content-Type: application/json
CompanyContactAttachedNotification
A contact was attached to a company.
Content-Type: application/json
CompanyContactDetachedNotification
A contact was detached from a company.
Content-Type: application/json
ContactArchivedNotification
A contact was archived.
Content-Type: application/json
ContactDeletedNotification
A contact was deleted.
Content-Type: application/json
ContactEmailUpdatedNotification
A contact's email address was changed.
Content-Type: application/json
ContactLeadAddedEmailNotification
A lead added an email address (without converting to a user).
Content-Type: application/json
ContactLeadCreatedNotification
A new lead contact was created.
Content-Type: application/json
ContactLeadSignedUpNotification
A lead converted into a user by signing up.
Content-Type: application/json
ContactLeadTagCreatedNotification
A tag was applied to a lead contact.
Content-Type: application/json
ContactLeadTagDeletedNotification
A tag was removed from a lead contact.
Content-Type: application/json
ContactLeadUpdatedNotification
A lead's attributes were updated.
Content-Type: application/json
ContactMergedNotification
Two contacts were merged.
Content-Type: application/json
ContactSubscribedNotification
A contact opted in to messaging.
Content-Type: application/json
ContactUnarchiveNotification
A previously archived contact was restored.
Content-Type: application/json
ContactUnsubscribedNotification
A contact opted out of messaging.
Content-Type: application/json
ContactUserCreatedNotification
A new user contact was created.
Content-Type: application/json
ContactUserTagCreatedNotification
A tag was applied to a user contact.
Content-Type: application/json
ContactUserTagDeletedNotification
A tag was removed from a user contact.
Content-Type: application/json
ContactUserUpdatedNotification
A user contact's attributes were updated.
Content-Type: application/json
ConversationAdminAssignedNotification
An admin or team was assigned to a conversation.
Content-Type: application/json
ConversationAdminClosedNotification
An admin closed a conversation.
Content-Type: application/json
ConversationAdminNotedNotification
An admin added a private note to a conversation.
Content-Type: application/json
ConversationAdminOpenAssignedNotification
An admin reopened and reassigned a conversation in a single action.
Content-Type: application/json
ConversationAdminOpenedNotification
An admin reopened a closed conversation.
Content-Type: application/json
ConversationAdminRepliedNotification
An admin posted a reply on a conversation.
Content-Type: application/json
ConversationAdminSingleCreatedNotification
An admin started a one-to-one conversation with a contact.
Content-Type: application/json
ConversationAdminSnoozedNotification
An admin snoozed a conversation.
Content-Type: application/json
ConversationAdminUnsnoozedNotification
A snoozed conversation woke up or was manually unsnoozed.
Content-Type: application/json
ConversationDeletedNotification
A conversation was deleted.
Content-Type: application/json
ConversationPartRedactedNotification
A conversation part was redacted.
Content-Type: application/json
ConversationPartTagCreatedNotification
A tag was applied to a conversation part.
Content-Type: application/json
ConversationPriorityUpdatedNotification
A conversation's priority flag changed.
Content-Type: application/json
ConversationRatingAddedNotification
A conversation rating was submitted by a contact.
Content-Type: application/json
ConversationReadNotification
A conversation was marked as read.
Content-Type: application/json
ConversationUserCreatedNotification
A contact (user or lead) started a new conversation.
Content-Type: application/json
ConversationUserRepliedNotification
A contact replied on an existing conversation.
Content-Type: application/json
ConversationContactAttachedNotification
A contact was attached as a participant on a conversation.
Content-Type: application/json
ConversationContactDetachedNotification
A contact was detached from a conversation.
Content-Type: application/json
EventCreatedNotification
A data event was tracked against a contact.
Content-Type: application/json
TicketCreatedNotification
A ticket was created.
Content-Type: application/json
TicketStateUpdatedNotification
A ticket's state changed.
Content-Type: application/json
TicketNoteCreatedNotification
A private note was added to a ticket.
Content-Type: application/json
TicketAdminAssignedNotification
A ticket was assigned to an admin.
Content-Type: application/json
TicketTeamAssignedNotification
A ticket was assigned to a team.
Content-Type: application/json
TicketContactAttachedNotification
A contact was attached to a ticket.
Content-Type: application/json
TicketContactDetachedNotification
A contact was detached from a ticket.
Content-Type: application/json
TicketAttributeUpdatedNotification
A custom or system ticket attribute was updated.
Content-Type: application/json
TicketAdminRepliedNotification
An admin replied on a ticket.
Content-Type: application/json
TicketContactRepliedNotification
A contact replied on a ticket.
Content-Type: application/json
TicketClosedNotification
A ticket was closed.
Content-Type: application/json
TicketRatingProvidedNotification
A rating was submitted on a ticket.
Content-Type: application/json
GranularSubscribeNotification
A contact opted in to a granular subscription type.
Content-Type: application/json
GranularUnsubscribeNotification
A contact opted out of a granular subscription type.
Content-Type: application/json
VisitorSignedUpNotification
An anonymous visitor signed up and became an identified user.
Content-Type: application/json
ContentStatBannerNotification
A delivery or engagement stat fired for a banner.
Content-Type: application/json
ContentStatCarouselNotification
A delivery or engagement stat fired for a carousel.
Content-Type: application/json
ContentStatChatNotification
A delivery or engagement stat fired for a chat message.
Content-Type: application/json
ContentStatChecklistNotification
A delivery or engagement stat fired for a checklist.
Content-Type: application/json
ContentStatCustomBotNotification
A delivery or engagement stat fired for a custom bot.
Content-Type: application/json
ContentStatEmailNotification
A delivery or engagement stat fired for an email.
Content-Type: application/json
ContentStatNewsItemNotification
A delivery or engagement stat fired for a news item.
Content-Type: application/json
ContentStatPostNotification
A delivery or engagement stat fired for a post.
Content-Type: application/json
ContentStatPushNotification
A delivery or engagement stat fired for a push notification.
Content-Type: application/json
ContentStatSeriesNotification
A delivery or engagement stat fired for a series.
Content-Type: application/json
ContentStatSeriesWebhookNotification
A webhook step inside a series fired.
Content-Type: application/json
ContentStatSmsNotification
A delivery or engagement stat fired for an SMS message.
Content-Type: application/json
ContentStatSurveyNotification
A delivery or engagement stat fired for a survey.
Content-Type: application/json
ContentStatTooltipGroupNotification
A delivery or engagement stat fired for a tooltip group.
Content-Type: application/json
ContentStatTourNotification
A delivery or engagement stat fired for a product tour.
Content-Type: application/json
About AsyncAPI
The AsyncAPI specification describes event-driven APIs the way OpenAPI describes request/response APIs. A channel is the named pipe — a webhook URL, a Kafka topic, a WebSocket route, an MQTT subject — that producers and consumers publish or subscribe to. Each channel carries one or more messages with structured payloads, and an operation declares whether a given party sends or receives on that channel.