Message Thread webhook

The Message Thread webhook is described below. Note that webhooks deliver only the event notification. The actual data must be read using the provided event details.

Webhook Subject: MESSAGE_THREAD

Supported events:

  • CREATE
  • UPDATE
  • DELETE

Summary

Message threads (AKA chat or messaging) events allow your integration to be notified on thread update

Description

Use the chat message thread updates to automate experiences like automatically adding members to the associated membership group for the message thread based on the purpose of the thread.

Message thread updates can also be used for experiences like when they are associated with an external customer conversation or task, adding members to ensure that the conversation is effective.

Message thread updates are also helpful for scenarios around moderation e.g. in a scenario like when building an intranet site with chat capabilities for employees, to moderate the usage.

Example

Below is an example webhook payload (pretty printed):

{
  "trigger" : {
    "urn" : "6099cb4a-00a5-4e08-8a8d-c570254b5757",
    "owner" : {
      "urn" : "32a90f18-aaa0-4bdc-a63e-4efd2e16c28c",
      "url" : "/n/v1/company/32a90f18-aaa0-4bdc-a63e-4efd2e16c28c"
    },
    "timestamp" : "2026-05-29T13:45:32",
    "subject" : "MESSAGE_THREAD",
    "event" : "CREATE",
    "targetUrn" : "fdcb0191-8408-4132-abf7-57adeafe59e2"
  },
  "subscription" : {
    "urn" : "691be1de-09df-411d-ad4a-3cc7ec771cd4",
    "subject" : "MESSAGE_THREAD",
    "event" : "ALL",
    "destinationUrl" : "https://example.com/webhooks/messagethread",
    "auth" : "BEARER",
    "expirationTimestamp" : "2026-06-28T13:45:32",
    "eventsPerMinute" : 500
  },
  "v1" : {
    "urn" : "fdcb0191-8408-4132-abf7-57adeafe59e2",
    "url" : "/n/v1/messagethread/fdcb0191-8408-4132-abf7-57adeafe59e2"
  }
}