Dovkie
Sign in
Back to monitors

notion

Notion API

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

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.

Alert history

  • 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.