Webhook topics and events
Log in to add to favouritesA 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. |