How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Contentful Webhooks

Contentful webhooks are HTTP callbacks that notify subscriber endpoints when content events (ContentType, Entry, Asset, Task, Comment, Release, Workflow, Template Installation) and action events (Release Actions, Bulk Actions, Scheduled Actions) occur in a space. Requests are POSTed as application/vnd.contentful.management.v1+json and, when a 64-character signing secret is configured, signed with HMAC-SHA256 via the x-contentful-signature, x-contentful-signed-headers, and x-contentful-timestamp headers.

Contentful Webhooks is one of 8 APIs that Contentful publishes on the APIs.io network, described by an AsyncAPI event-driven specification.

Tagged areas include CMS, Content, Webhook, and Event. The published artifact set on APIs.io includes API documentation and an AsyncAPI specification.

This event API exposes 48 operations across 48 channels, and defines 16 schemas. It is described by AsyncAPI 2.6.0, at version 1.0.

The API connects through a single server, {webhookUrl} (https).

48 operations 48 channels 16 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 2.6.0
API Version
1.0
Server
{webhookUrl} (https)
Resource Areas
1

Channels & Operations 48

Across 48 channels, the API surfaces 48 operations. Each is listed below with its action, channel, parameters, and response codes.

Channels 48
PUB
ContentType.create
A content type was created.
onContentTypeCreate body
PUB
ContentType.save
A content type was saved.
onContentTypeSave body
PUB
ContentType.publish
A content type was published.
onContentTypePublish body
PUB
ContentType.unpublish
A content type was unpublished.
onContentTypeUnpublish body
PUB
ContentType.delete
A content type was deleted.
onContentTypeDelete body
PUB
Entry.create
An entry was created.
onEntryCreate body
PUB
Entry.save
An entry was saved.
onEntrySave body
PUB
Entry.auto_save
An entry was auto-saved.
onEntryAutoSave body
PUB
Entry.archive
An entry was archived.
onEntryArchive body
PUB
Entry.unarchive
An entry was unarchived.
onEntryUnarchive body
PUB
Entry.publish
An entry was published.
onEntryPublish body
PUB
Entry.unpublish
An entry was unpublished.
onEntryUnpublish body
PUB
Entry.delete
An entry was deleted.
onEntryDelete body
PUB
Asset.create
An asset was created.
onAssetCreate body
PUB
Asset.save
An asset was saved.
onAssetSave body
PUB
Asset.auto_save
An asset was auto-saved.
onAssetAutoSave body
PUB
Asset.archive
An asset was archived.
onAssetArchive body
PUB
Asset.unarchive
An asset was unarchived.
onAssetUnarchive body
PUB
Asset.publish
An asset was published.
onAssetPublish body
PUB
Asset.unpublish
An asset was unpublished.
onAssetUnpublish body
PUB
Asset.delete
An asset was deleted.
onAssetDelete body
PUB
Task.create
A task was created.
onTaskCreate body
PUB
Task.save
A task was saved.
onTaskSave body
PUB
Task.delete
A task was deleted.
onTaskDelete body
PUB
Comment.create
A comment was created.
onCommentCreate body
PUB
Comment.save
A comment was saved.
onCommentSave body
PUB
Comment.delete
A comment was deleted.
onCommentDelete body
PUB
Release.create
A release was created.
onReleaseCreate body
PUB
Release.save
A release was saved.
onReleaseSave body
PUB
Release.archive
A release was archived.
onReleaseArchive body
PUB
Release.unarchive
A release was unarchived.
onReleaseUnarchive body
PUB
Release.delete
A release was deleted.
onReleaseDelete body
PUB
ReleaseAction.create
A release action (publish or unpublish) was created.
onReleaseActionCreate body
PUB
ReleaseAction.execute
A release action was executed against the referenced content.
onReleaseActionExecute body
PUB
BulkAction.create
A bulk action containing a collection of entries and assets was created.
onBulkActionCreate body
PUB
BulkAction.execute
A bulk action was executed against the referenced content.
onBulkActionExecute body
PUB
ScheduledAction.create
A scheduled action was created.
onScheduledActionCreate body
PUB
ScheduledAction.save
A scheduled action was saved.
onScheduledActionSave body
PUB
ScheduledAction.execute
A scheduled action was executed at its scheduled time.
onScheduledActionExecute body
PUB
ScheduledAction.delete
A scheduled action was deleted (cancelled).
onScheduledActionDelete body
PUB
Workflow.create
A workflow was created.
onWorkflowCreate body
PUB
Workflow.save
A workflow was saved.
onWorkflowSave body
PUB
Workflow.complete
A workflow was completed.
onWorkflowComplete body
PUB
TemplateInstallation.complete
A template installation was completed.
onTemplateInstallationComplete body
PUB
EntryVersion.save
An entry version was saved (Timeline event; limited plan availability).
onEntryVersionSave body
PUB
EntryVersion.auto_save
An entry version was auto-saved (Timeline event; limited plan availability).
onEntryVersionAutoSave body
PUB
AssetVersion.save
An asset version was saved (Timeline event; limited plan availability).
onAssetVersionSave body
PUB
AssetVersion.auto_save
An asset version was auto-saved (Timeline event; limited plan availability).
onAssetVersionAutoSave body

Messages & Schemas 16

The contract defines 16 schemas that model the data carried by its messages. The most detailed is CommonHeaders (7 properties). Each schema is shown below with its type and property counts.

ContentTypeEvent
message
Sent when a content type changes state.
EntryEvent
message
Sent when an entry changes state.
AssetEvent
message
Sent when an asset changes state.
TaskEvent
message
Sent when a task changes state.
CommentEvent
message
Sent when a comment changes state.
ReleaseEvent
message
Sent when a release entity itself is created, saved, archived, unarchived, or deleted (not when an action is taken on its contents).
ReleaseActionEvent
message
Sent when a release action (publish or unpublish of release contents) is created or executed.
BulkActionEvent
message
Sent when a bulk action containing a collection of entries and assets is created or executed.
ScheduledActionEvent
message
Sent when a scheduled action is created, saved, executed, or deleted.
WorkflowEvent
message
Sent when a workflow is created, saved, or completed.
TemplateInstallationEvent
message
Sent when a template installation has completed.
CommonHeaders
object
Standard headers Contentful adds to every webhook request. Subscribers may also configure additional custom headers and secret headers during webhook setup.
7 properties
ReleaseHeaders
object
BulkActionHeaders
object
ScheduledActionHeaders
object
Resource
object
Contentful Management API resource representation for the entity that triggered the event. Shape follows the application/vnd.contentful.management.v1+json enve…

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

contentful-webhooks-asyncapi.yml Raw ↑

Other APIs Contentful publishes across the network.

Contentful Content Management API
Contentful Preview API
Contentful Images API
Contentful GraphQL Content API
Contentful User Management API
Contentful SCIM API
Contentful Spaces API
Where this information came from

This is an independent, third-party profile of Contentful Webhooks, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.