Image Item webhook

The Image Item 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: IMAGE_ITEM

Supported events:

  • CREATE
  • UPDATE
  • DELETE

Summary

Webhook events related to updates to an image item associated with an entity.

Description

Listen to events to be notified when an image is updated to trigger experiences like cache invalidation for the image files. Other experiences may also be triggered like integrating a QA process for the created image.

As with other content items image updates result in a new draft item being created which is returned as the update.

Note that image file uploads to the associated image also trigger events on the same subject though the file name may not change dependent upon the uploaded file name normalisation.

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