Entity webhook

The Entity 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: ENTITY

Supported events:

  • CREATE
  • UPDATE
  • DELETE

Summary

Webhook for updates related to content entities as well as company, membership group and other internal content entities.

Description

Content entities are central to the platform and notifications on updates are critical to maintaining business continuity. Subscribe to updates for entities including changes in publication state, updated future publication time but also updates related the entities variant or language. While the API will allow operations like updating the variant monitoring this or other actions like renaming the entity can be critical to business continuity.

Note that the entity view (rendered) does not have a webhook as the results of the rendered entity are dynamic based execution.

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" : "ENTITY",
    "event" : "CREATE",
    "targetUrn" : "fdcb0191-8408-4132-abf7-57adeafe59e2"
  },
  "subscription" : {
    "urn" : "691be1de-09df-411d-ad4a-3cc7ec771cd4",
    "subject" : "ENTITY",
    "event" : "ALL",
    "destinationUrl" : "https://example.com/webhooks/entity",
    "auth" : "BEARER",
    "expirationTimestamp" : "2026-06-28T13:45:32",
    "eventsPerMinute" : 500
  },
  "v1" : {
    "urn" : "fdcb0191-8408-4132-abf7-57adeafe59e2",
    "url" : "/n/v1/entity/fdcb0191-8408-4132-abf7-57adeafe59e2"
  }
}