Single inbound channel that receives every Notion webhook delivery,
including the one-time verification handshake and all event types.
Notion dispatches each event as an HTTP POST with a JSON body and
an `X-Notion-Signature` header.
One-time verification payload sent when a webhook subscription is created.
Content-Type: application/json
PageCreated
A page was created in the workspace.
Content-Type: application/json
PageUpdated
A page was updated (legacy alias covering property and content updates).
Content-Type: application/json
PageContentUpdated
One or more blocks on a page were updated.
Content-Type: application/json
PagePropertiesUpdated
One or more properties on a page were updated.
Content-Type: application/json
PageMoved
A page was moved to a different parent.
Content-Type: application/json
PageDeleted
A page was moved to the trash.
Content-Type: application/json
PageUndeleted
A page was restored from the trash.
Content-Type: application/json
PageLocked
A page was locked.
Content-Type: application/json
PageUnlocked
A page was unlocked.
Content-Type: application/json
DatabaseCreated
A database was created.
Content-Type: application/json
DatabaseContentUpdated
Content within a database was updated. Deprecated in API version 2025-09-03.
Content-Type: application/json
DatabaseMoved
A database was moved to a different parent.
Content-Type: application/json
DatabaseDeleted
A database was moved to the trash.
Content-Type: application/json
DatabaseUndeleted
A database was restored from the trash.
Content-Type: application/json
DatabaseSchemaUpdated
A database schema was updated. Deprecated in API version 2025-09-03.
Content-Type: application/json
DataSourceCreated
A data source was created (API version 2025-09-03 and later).
Content-Type: application/json
DataSourceContentUpdated
Content within a data source was updated (API version 2025-09-03 and later).
Content-Type: application/json
DataSourceMoved
A data source was moved (API version 2025-09-03 and later).
Content-Type: application/json
DataSourceDeleted
A data source was deleted (API version 2025-09-03 and later).
Content-Type: application/json
DataSourceUndeleted
A data source was restored (API version 2025-09-03 and later).
Content-Type: application/json
DataSourceSchemaUpdated
A data source schema was updated (API version 2025-09-03 and later).
Content-Type: application/json
CommentCreated
A comment was created. Requires the comment read capability.
Content-Type: application/json
CommentUpdated
A comment was updated. Requires the comment read capability.
Content-Type: application/json
CommentDeleted
A comment was deleted. Requires the comment read capability.
Content-Type: application/json
About AsyncAPI
The AsyncAPI specification describes event-driven APIs the way OpenAPI describes request/response APIs. A channel is the named pipe — a webhook URL, a Kafka topic, a WebSocket route, an MQTT subject — that producers and consumers publish or subscribe to. Each channel carries one or more messages with structured payloads, and an operation declares whether a given party sends or receives on that channel.