Skip to main content
Browse Documentation

Webhook topics and events

Created by r.saunders, last modified by r.bromley on 09 Apr 2021

A webhook is triggered when an event takes place on a Contensis resource. We call these topics. When creating a webhook you need to set the conditions for when the webhook is triggered. A topic can also be filtered to scope the webhook to a particular set of conditions.

Supported topics

We support the following topics and events.

Entries: basic events

Event Description
Created When an entry is created.
Updated When an entry is updated.
Deleted When an entry is deleted.
Published When an entry is published.
Unpublished When an entry is unpublished.

Filters

Filter Description
Content type(s) Scope the entries to a particular content type(s).
Content owner Filter the entries to a specific content owner.
Language(s) Scope the entries to specific or multiple languages.

Entries: workflow events

Workflow events are triggered when a user carries out a particular workflow action on an entry. For example, if an approver presses the decline button in an approval workflow state.

Workflow events are specific to each workflow. This allows you to trigger a webhook for items that have been declined in an approval workflow but not from a custom workflow. You can also filter these events further by assigning filters.

Filters

Filter Description
Content type(s) Scope the entries to a particular content type(s).
Content owner Filter the entries to a specific content owner.
Language(s) Scope the entries to specific or multiple languages.

Entries: workflow transition

Workflow transitions are a powerful topic allowing you to understand when content transitions into a specific workflow state.

This is especially helpful when you want to notify a team of editors that a piece of content is ready to review or to notify an integration you've created that there is a set of entries ready to process.

Workflow transitions can be filtered by the following types.

Filters

Filter Description
Content type(s) Scope the entries to a particular content type(s).
Content owner Filter the entries to a specific content owner.
Language(s) Scope the entries to specific or multiple languages.

Assets

Event Description
Created When an asset is created.
Updated When an asset is updated.
Deleted When an asset is deleted.
Published When an asset is published.

Filters

Filter Description
Asset type(s) Scope the entries to a particular file type(s).
Language(s) Scope the entries to specific or multiple languages.

Content types and components

Event Description
Created When a content type or component is created.
Updated When a content type or component is updated.
Deleted When a content type or component is deleted.
Published When a content type or component is published.

Nodes

Event Description
Created When a node is created.
Updated When a node is updated or moved.
Deleted When a node is deleted.

Project

Webhooks are scoped to a project so the only event that is supported is the update event.

Event Description
Updated When a node is updated or moved.