Dovkie
Sign in
Back to monitors

notion

Notion API

REST
OpenAPI (JSON)
https://developers.notion.com/openapi.json
Additive AI classification

Add webhook endpoints for pages and views

This diff adds multiple new webhook endpoint definitions to the Notion API specification. New endpoints include page lifecycle webhooks (pageCreated, pageDeleted, pageUndeleted, pageLocked, pageUnlocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted) and view webhooks (viewCreated, viewDeleted, viewUpdated). These are purely additive webhook receiver paths that complement the existing webhook system without modifying any existing endpoints or breaking existing integrations.

Alert history

  • Additive

    Add webhook endpoints for pages and views

    This diff adds multiple new webhook endpoint definitions to the Notion API specification. New endpoints include page lifecycle webhooks (pageCreated, pageDeleted, pageUndeleted, pageLocked, pageUnlocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted) and view webhooks (viewCreated, viewDeleted, viewUpdated). These are purely additive webhook receiver paths that complement the existing webhook system without modifying any existing endpoints or breaking existing integrations.

  • Informational

    Notion OpenAPI spec reformatted; webhooks section added

    The entire Notion OpenAPI spec has been reformatted (indentation style changed from 2-space to tab-based), resulting in ~33k lines removed and ~33k lines added with no apparent semantic change to existing REST endpoints. The visible tail of the diff shows a large new webhooks section added to the spec, documenting callback event types for pages, databases, views, file uploads, and comments (e.g. pageCreated, pageDeleted, viewUpdated, fileUploadUploadFailed). These appear to be documentation additions for inbound webhook payloads, not new REST endpoints clients call directly.

  • Additive

    Add webhook endpoints for page and view events

    The Notion API adds 12 new webhook endpoint definitions for page events (pageCreated, pageDeleted, pageLocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted, pageUndeleted, pageUnlocked) and view events (viewCreated, viewDeleted, viewUpdated). These are new POST endpoints that enable receiving webhook notifications for various page and view state changes, without affecting existing endpoints or functionality.

  • Additive

    Notion API spec adds webhook event definitions and restructures OpenAPI doc

    The OpenAPI spec has been substantially restructured (33k+ lines removed, 33k+ added), with the most visible new content being a large set of webhook callback definitions covering pages, databases, views, comments, file uploads, and more (e.g. pageCreated, pageDeleted, pageContentUpdated, viewCreated, fileUploadUploadFailed, etc.). The diff is truncated so the full scope of schema-level changes cannot be confirmed, but the visible additions are purely additive webhook event payloads. Existing REST endpoint consumers are unlikely to be broken, but teams building webhook receivers should review the new payload schemas.

  • Additive

    Add 11 new webhook endpoint schemas

    The Notion API OpenAPI specification has added 11 new webhook endpoint definitions including pageCreated, pageDeleted, pageLocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted, pageUndeleted, pageUnlocked, and 3 view-related webhooks (viewCreated, viewDeleted, viewUpdated). These are new optional webhook event types that integrate teams can subscribe to; existing integrations are unaffected.

  • Additive

    Add transcription_failed status to meeting notes

    A new transcription_failed enum value has been added to the transcription status field for meeting notes. This is an additive change that allows clients to handle transcription failures more explicitly without breaking existing integrations.

  • Informational

    Notion OpenAPI spec reformatted and webhook callbacks added

    The entire Notion OpenAPI spec has been reformatted (indentation changed from 2-space to tab-based, openapi version field restructured), and a large set of webhook callback definitions have been added as OpenAPI webhooks entries (e.g. pageCreated, pageDeleted, pageContentUpdated, viewCreated, fileUploadUploadFailed, etc.). The diff is mostly structural/formatting churn with ~33k lines removed and ~33k lines added, but the net-new webhooks section documents new event payloads that integrators can now reference. No existing REST endpoints appear to have been removed or altered based on the visible diff.

  • Additive

    New webhook event endpoints added for pages and views

    The OpenAPI specification adds new webhook event endpoints for page lifecycle events (pageCreated, pageDeleted, pageMoved, etc.) and view operations (viewCreated, viewDeleted, viewUpdated), along with a transcription block transcript deletion event. These are additive webhook handler endpoints that document where events are sent but do not change existing API behaviour or break current integrations.

  • Additive

    Notion API spec adds large webhook event catalog and restructures spec

    The spec snapshot was largely rewritten (33k lines added, 36k removed), with the visible tail showing a new set of webhook callback definitions added under webhooks (OpenAPI 3.1 webhooks object). New webhook event types documented include page lifecycle events (pageCreated, pageDeleted, pageContentUpdated, pageLocked, pageUnlocked, pageMoved, pagePropertiesUpdated, pageUndeleted, pageTranscriptionBlockTranscriptDeleted), view events (viewCreated, viewDeleted, viewUpdated), and file-upload events. Because the diff is heavily truncated in the middle, the full scope of changes (including any breaking changes to existing REST endpoints) cannot be determined with certainty; however, the visible changes are additive webhook documentation additions.

  • Additive

    Add webhook endpoint definitions for pages and views

    The OpenAPI specification adds webhook endpoint definitions for page and view events, including pageCreated, pageDeleted, pageLocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted, pageUndeleted, pageUnlocked, viewCreated, viewDeleted, and viewUpdated. These are new webhook event handlers that allow clients to subscribe to workspace events without breaking existing integrations.

  • Additive

    Add async task retrieval endpoint

    New GET /v1/async_tasks/{task_id} endpoint added to retrieve the status and results of async operations. This is a purely additive change that enables clients to poll async task completion without breaking existing functionality.

  • Additive

    Add email_verified field to person object

    The Notion API adds a new optional email_verified boolean field to the person object across multiple endpoints and response schemas. This addition enables clients to check whether a person's email has been verified. Since the field is optional and new fields do not break existing clients, this is a purely additive change.

  • Additive

    Add webhook endpoint definitions for pages and views

    The API specification adds webhook endpoint definitions for 11 new page and view webhook events. These include page events (created, deleted, undeleted, locked, unlocked, content updated, properties updated, moved, transcript deleted) and view events (created, deleted, updated). The new endpoints follow the webhook pattern with POST methods that accept event payloads and return 200 status codes. This expands webhook coverage for Notion workspace events without breaking existing functionality.

  • Additive

    Add webhook event definitions for pages and views

    The OpenAPI spec now includes webhook endpoint definitions for page and view lifecycle events, including pageCreated, pageDeleted, pageLocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted, pageUndeleted, pageUnlocked, and view events (viewCreated, viewDeleted, viewUpdated). These are new schema references and endpoint documentation for webhook handling; they are additive and do not break existing API consumers.

  • Informational

    Notion API webhook endpoints documentation restructured

    The Notion API OpenAPI specification has been restructured, with webhook endpoint documentation reorganized from a flat schema-based approach to a structured paths-based format. The change converts webhook definitions (database webhooks, page webhooks, view webhooks, file upload webhooks) from component schemas into explicit POST endpoints in the OpenAPI spec. This improves API documentation discoverability and tooling support without changing the actual webhook functionality or authentication requirements.

  • Additive

    Add async task support to PATCH /v1/pages/:page_id/markdown

    The PATCH /v1/pages/:page_id/markdown endpoint now supports an optional allow_async parameter to enable asynchronous execution, returning a new 202 response with async task details when opted in. The request schema is restructured from oneOf to allOf to allow the allow_async option at the top level alongside the existing content update types (which remain unchanged as the second oneOf). All existing synchronous behavior is preserved as the default when allow_async is omitted or false.

  • Additive

    Add webhook endpoints for pages and views

    The Notion API specification adds new webhook endpoints for page and view events: pageCreated, pageDeleted, pageLocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted, pageUndeleted, pageUnlocked, viewCreated, viewDeleted, and viewUpdated. These are purely additive POST endpoints for webhook event handling that do not change any existing functionality.

  • Additive

    Add webhook event endpoints for pages and views

    The Notion API OpenAPI specification adds webhook event endpoints for page lifecycle events (pageCreated, pageDeleted, pageContentUpdated, pagePropertiesUpdated, pageLocked, pageUnlocked, pageMoved, pageUndeleted, and pageTranscriptionBlockTranscriptDeleted) and view events (viewCreated, viewDeleted, viewUpdated), along with a fileUploadUploadFailed webhook endpoint. These are purely additive POST endpoints that do not change existing API behavior.

  • Additive

    Add 8 new page and view webhook endpoints

    The Notion API adds 8 new webhook-style endpoints for page and view events: pageCreated, pageDeleted, pageLocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted, pageUndeleted, pageUnlocked, and viewCreated, viewDeleted, viewUpdated. These are additive POST endpoints with corresponding webhook payload schemas and do not break existing integrations.

  • Informational

    OpenAPI spec restructured to separate webhook paths

    The Notion API OpenAPI specification has been restructured to separate webhook endpoint definitions into a new paths section with individual webhook endpoints (e.g., fileUploadUploadFailed, pageContentUpdated, etc.). This is a documentation reorganization that makes webhook contracts more explicit and easier to discover in the OpenAPI schema, but does not change any functional API behavior or authentication requirements.

  • Additive

    New webhook events for page and view operations

    The Notion API spec adds new webhook event endpoints for page and view operations: page created, page deleted, page locked, page moved, page properties updated, page transcript deleted, page undeleted, page unlocked, view created, view deleted, and view updated. These are new POST endpoints that receive webhook payloads and are purely additive — existing integrations are unaffected, though webhook subscriptions can now listen to these additional page and view lifecycle events.

  • Informational

    Notion API spec restructured from swagger to webhook paths

    The Notion API OpenAPI specification has been significantly restructured. The original spec was compressed into a much smaller size (31,625 lines vs. 34,813), and the tail of the diff shows addition of explicit webhook event paths that appear to define POST endpoints for various webhook payload types (file upload, page events, view events). The changes are primarily structural documentation/specification reorganization rather than functional API changes; webhook support itself is not new, but the OpenAPI spec structure for defining webhook paths has been updated.

  • Additive

    Add webhook endpoint definitions and schemas

    The API spec adds webhook endpoint definitions and corresponding payload schema definitions for page and view events (created, deleted, locked, moved, properties updated, undeleted, unlocked, and transcription updates). These are new optional webhook event types that integrations can subscribe to but do not affect existing REST API endpoints.

  • Informational

    OpenAPI spec reformatted with whitespace/indentation changes

    The Notion API OpenAPI specification has been reformatted with updated whitespace and indentation (from 2-space to tab indentation). The visible tail of the diff shows webhook endpoint definitions remain structurally unchanged. While the diff is substantial in size (~2,700 net lines removed), the reformatting itself does not alter API behaviour, documented endpoints, fields, or parameters — it is a structural reorganization of the JSON document.

  • Additive

    New page and view webhook event endpoints

    Added 8 new webhook event endpoints for page lifecycle events (pageCreated, pageDeleted, pageLocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted, pageUndeleted, pageUnlocked) and 3 new webhook endpoints for view operations (viewCreated, viewDeleted, viewUpdated). These are purely additive webhook event handlers that do not affect existing API behavior.

  • Informational

    Notion OpenAPI spec reformatted; webhook callbacks added

    The entire Notion OpenAPI spec has been reformatted (indentation style changed from spaces to tabs, reducing line count by ~3K net), and a large set of webhook callback paths have been added as OpenAPI webhooks objects. New webhook events include page lifecycle (pageCreated, pageDeleted, pageContentUpdated, pageMoved, pageLocked, pageUnlocked, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted, pageUndeleted), view lifecycle (viewCreated, viewDeleted, viewUpdated), and file upload events (fileUploadUploadFailed). These are receiver-side webhook definitions and do not change existing REST API endpoints, but teams building webhook integrations should be aware of the newly documented event types and their payload schemas.

  • Additive

    Add webhook receiver endpoints for page and view events

    The Notion API OpenAPI spec now documents webhook receiver endpoints for page lifecycle events (created, deleted, locked, moved, properties updated, undeleted, unlocked, transcript deleted) and view events (created, deleted, updated). These are purely additive endpoints that document how to receive webhook payloads—they do not break existing integrations and allow developers to implement webhook handlers.

  • Additive

    Add webhook event paths for pages and views

    The OpenAPI spec adds new webhook event path definitions for page and view events, including operations for pageContentUpdated, pageCreated, pageDeleted, pageLocked, pageMoved, pagePropertiesUpdated, pageTranscriptionBlockTranscriptDeleted, pageUndeleted, pageUnlocked, and view events (viewCreated, viewDeleted, viewUpdated). These are new webhook payload schemas and endpoint documentation that extend webhook coverage without modifying existing endpoints or schemas.

  • Additive

    Developer portal and personal access tokens now available

    The changelog adds a new May 12, 2026 entry announcing the Developer portal for managing Notion developer tools and the availability of Personal access tokens (PATs) as user-scoped authentication tokens. This is a new feature that provides additional authentication options and management capabilities alongside existing methods; it does not modify or remove any existing API behavior.