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.
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.