# Notion API changelog

We check Notion's developer changelog every day, because we run production integrations on the Notion API. This page lists the 72 changes we have recorded since monitoring started on 26 March 2026, newest first. Our last successful check was on 28 September 2026. We are on it; until then this page may miss the newest changes.

**In short:** 1 breaking change and 0 deprecations in the Notion API in the last 90 days. The latest: “Notion app links domain change to notion.com” (15 July 2026).

- [Official Notion changelog](https://developers.notion.com/page/changelog)
- [RSS feed: Notion API changes](https://seamless.engineering/api-changelog/notion/rss.xml)

## Notion API changes

Labels are assigned automatically. Check the vendor's note before planning work around an entry.

### July 2026

- **Per-tool access map in notion-fetch self** (New feature, 17 Jul 2026): The notion-fetch MCP tool's self response now includes a current_tool_access map showing which tools are available on the workspace's plan before making calls.
- **New identity fields in OAuth token responses** (New feature, 15 Jul 2026): User objects now include email_verified boolean, and Notion MCP token responses include user_id, workspace_id, and email_domain fields for better connection identification.
- **Notion app links domain change to notion.com** (Breaking, 15 Jul 2026): API-generated links for pages, databases, and data sources now use notion.com domain instead of notion.so, with URLs formatted as https://app.notion.com/p/{page-id}.
- **Search the trash and query archived pages** (New feature, 15 Jul 2026): Search endpoint now accepts filter.in_trash option to list trashed items, and Query data source accepts is_archived parameter for archived pages.
- **Longer-lived Notion MCP access tokens** (Other, 14 Jul 2026): Notion MCP access tokens now last about eight hours instead of one hour.
- **Automatic retry of service_overload responses** (Bug fix, 8 Jul 2026): SDK v5.23.0 now automatically retries HTTP 529 service_overload responses with Retry-After header respect.
- **Read every row in a large data source** (New feature, 8 Jul 2026): New SDK helpers iterateAllDataSourceRows() and collectAllDataSourceRows() enable pagination beyond the 10,000 result limit for large data sources.
- **Start and poll async page writes** (New feature, 8 Jul 2026): notion.asyncTasks.retrieve() and allow_async parameter enable asynchronous large markdown writes with polling.
- **Verify webhook signatures with one call** (New feature, 8 Jul 2026): New verifyWebhookSignature() helper in SDK v5.23.0 simplifies webhook authentication verification.
- **HTML blocks via the API** (New feature, 3 Jul 2026): You can now create HTML blocks by uploading .html files and attaching them to embed blocks via embed.file_upload.
- **Personal access token expiration options** (New feature, 2 Jul 2026): When creating personal access tokens, users can now select expiration periods of 7, 30, 90, 180 days or 1 year instead of fixed 1 year.
- **Database icon retrieval** (New feature, 1 Jul 2026): databases.retrieve now returns the icon set in Notion UI, matching data source icon behavior.
- **Icon names and database icons** (New feature, 1 Jul 2026): Icon name field now accepts icon picker names like 'token' and 'star circle', and databases.retrieve now returns the UI icon.

### June 2026

- **Async page markdown writes** (New feature, 29 Jun 2026): Create and update page markdown endpoints now accept allow_async: true for large requests that return async_task handles for polling.
- **Get workspace and user identity with notion-fetch** (New feature, 25 Jun 2026): notion-fetch MCP tool now accepts special id 'self' to return connected workspace and user identity without extra API calls.
- **Poll async MCP tool tasks with notion-get-async-task** (New feature, 25 Jun 2026): New MCP tool for polling the status of async tasks started by other tools like notion-duplicate-page or notion-create-pages, returning queued/running/retrying/succeeded/failed status.
- **AI assistant expanded access for Business + Notion AI plans** (New feature, 22 Jun 2026): Business plan teams with Notion AI can now query single databases/views directly from AI assistants, previously requiring Enterprise plan.
- **Consistent set of Notion MCP tools on every plan** (New feature, 22 Jun 2026): All plans now see the same MCP tools with clear upgrade messages instead of hidden tools; notion-query-data-sources now available on Business plans (previously Enterprise only).
- **Expanded AI assistant access and status option groups** (New feature, 22 Jun 2026): Business + Notion AI plans can now query single databases from AI assistants; status property options now support optional group field assignment.
- **Status option groups** (New feature, 22 Jun 2026): Status property options now accept optional group field to assign options to 'To-do', 'In progress', or 'Complete' groups.
- **Workspace-level rate limits** (Other, 16 Jun 2026): Notion API now applies rate limits per workspace in addition to per-connection limits, scaled to workspace plan.
- **Bots in people properties and user mentions** (New feature, 10 Jun 2026): Bots can now be assigned to people properties and referenced in user rich text mentions.
- **Unique access tokens per OAuth authorization** (Breaking, 8 Jun 2026): New public connections now mint fresh access_token and refresh_token for each OAuth authorization instead of reusing existing tokens.

### May 2026

- **Markdown page insertion positions** (New feature, 15 May 2026): Update page markdown endpoint now supports `insert_content.position` to prepend or append content without rewriting full page.
- **Developer portal and personal access tokens** (New feature, 12 May 2026): New Developer portal provides single place to manage connections, Workers, and personal access tokens with workspace admin PAT management.
- **agent_id parent type** (New feature, 11 May 2026): Pages and blocks parented by an agent now serialize with parent type 'agent_id' instead of being rejected or rewritten.
- **Query meeting notes endpoint** (New feature, 11 May 2026): New POST /v1/blocks/meeting_notes/query endpoint returns AI meeting notes with optional filters, sorts, and limits.

### April 2026

- **Pagination cursor improvements** (Bug fix, 22 Apr 2026): Query data source pagination cursors now embed session identifiers to eliminate intermittent validation errors from overlapping pagination sessions.
- **Pagination cursor reliability improvements** (Bug fix, 22 Apr 2026): Query data source pagination cursors now embed session identifiers to eliminate validation errors from overlapping pagination sessions.
- **Data source and view query pagination limit** (Breaking, 20 Apr 2026): Query endpoints now enforce maximum pagination depth of 10,000 results per query with new request_status field indicating incomplete results.
- **Comment markdown formatting clarification** (Other, 17 Apr 2026): Create and update comment endpoints now explicitly document that markdown parameter supports only inline formatting, not structured blocks.
- **Multi-value filters for select, status, and multi_select properties** (New feature, 17 Apr 2026): Database and data source filters now accept arrays of values for equals/does_not_equal on select/status and contains/does_not_contain on multi_select.
- **Notion MCP improvements** (New feature, 17 Apr 2026): MCP search, fetch, and markdown tools improved with better Slack integration, domain handling, archive indicators, and CIMD OAuth support.
- **Update and delete comment endpoints** (New feature, 17 Apr 2026): Update a comment (PATCH /v1/comments/:comment_id) and Delete a comment (DELETE /v1/comments/:comment_id) endpoints are now generally available.
- **Markdown body parameter for comments** (New feature, 7 Apr 2026): Create comment endpoint now accepts optional markdown string parameter as alternative to rich_text; exactly one must be provided.
- **Developer Terms updated** (Other, 2 Apr 2026): Developer Terms updated with clarifications to scope, revisions to Feedback provision, and other minor changes.

### March 2026

- **Heading 4 block type** (New feature, 30 Mar 2026): heading_4 is now a supported block type alongside heading_1, heading_2, and heading_3.
- **Me relative filter for people properties** (New feature, 30 Mar 2026): People filter conditions now accept 'me' value for contains and does_not_contain, resolving to authorized user for public integrations.
- **Relative date filter values** (New feature, 30 Mar 2026): Date filter conditions now accept relative date values: 'today', 'tomorrow', 'yesterday', 'one_week_ago', 'one_week_from_now', 'one_month_ago', 'one_month_from_now'.
- **Tab item icons** (New feature, 30 Mar 2026): Paragraph blocks that are direct children of tab blocks now support optional icon field when creating or updating tabs.
- **View API fixes** (Bug fix, 30 Mar 2026): Fixed percent-encoded property IDs in view filters, rejected width: 0 for columns, and fixed partial properties list behavior.
- **View API fixes** (Bug fix, 30 Mar 2026): Fixes for percent-encoded property IDs resolution, minimum column width enforcement (minimum 1), and partial properties list visibility in views.
- **Native icons and custom emoji listing** (New feature, 25 Mar 2026): Native Notion icons now return as type: 'icon' with name and color; new List custom emojis endpoint retrieves workspace custom emojis.
- **Tab block support** (New feature, 25 Mar 2026): Tab blocks are now supported for reading and creating; each tab is a paragraph block with nested children and optional icon.
- **Writable verification property** (New feature, 25 Mar 2026): Verification property on wiki database pages can now be set and updated via Create/Update page endpoints.
- **Status property support** (New feature, 19 Mar 2026): Status properties now creatable and updatable via API and MCP; specify {status: {}} with optional custom options in Create database/data source requests.
- **Status property support** (New feature, 19 Mar 2026): Status properties can now be created and updated through the API with custom options, previously read-only.
- **Views API launch** (New feature, 19 Mar 2026): Eight new endpoints for programmatic view management: create, retrieve, update, delete views; list views; and query views with pagination support.
- **Views API launch** (New feature, 19 Mar 2026): Eight new endpoints enable programmatic management of database views including create, retrieve, update, delete, list, and query operations.
- **Markdown content API improvements** (New feature, 11 Mar 2026): Update page markdown endpoint now supports update_content and replace_content command types for targeted edits.
- **New API version 2026-03-11 with breaking changes** (Breaking, 11 Mar 2026): API version 2026-03-11 replaces 'after' with 'position', 'archived' with 'in_trash', and renames 'transcription' to 'meeting_notes' block type.
- **Notion MCP new view tools** (New feature, 11 Mar 2026): New MCP tools for creating and updating database views with full configuration support including filters, sorts, and layout-specific settings.
- **Template timezone parameter** (New feature, 11 Mar 2026): Create and update page endpoints now accept optional timezone field in template parameter to control template variable resolution.
- **Markdown endpoint access for internal integrations** (New feature, 2 Mar 2026): GET /v1/pages/:page_id/markdown endpoint now available to internal integrations, previously public-only.

### February 2026

- **AI meeting notes support** (New feature, 26 Feb 2026): Markdown retrieval endpoint supports `include_transcript` parameter; new transcription block type for reading AI meeting notes metadata.
- **Markdown content API** (New feature, 26 Feb 2026): Three new endpoints (POST /v1/pages with markdown, GET /v1/pages/:page_id/markdown, PATCH /v1/pages/:page_id/markdown) enable page content management using enhanced markdown.
- **Notion MCP improvements** (New feature, 26 Feb 2026): Multiple MCP enhancements including block comments, Notion Sites support, meeting transcripts, data source queries, schema optimization, and enterprise governance.
- **SDK automatic retry with exponential backoff** (New feature, 26 Feb 2026): JavaScript/TypeScript SDK now retries failed requests automatically with configurable backoff.

### January 2026

- **Data source templates API** (New feature, 15 Jan 2026): New List data source templates endpoint and template parameter in Create/Update page endpoints for page template support.
- **List data source templates endpoint** (New feature, 15 Jan 2026): New endpoint to list available templates for creating data sources.
- **Move page API** (New feature, 15 Jan 2026): New endpoint to change the parent of an existing page.
- **Notion MCP tool consolidation and fixes** (New feature, 15 Jan 2026): Tool consolidation removed notion-get-user, fixed delete bug with replace_content, and reduced context tokens.
- **Page erase_content parameter** (New feature, 15 Jan 2026): Update page endpoint now supports erase_content parameter to remove content from pages.
- **Page position customization** (New feature, 15 Jan 2026): Support added for customizing the position of a new page within the parent page when creating pages.

### September 2025

- **SDK CreateDataSourceBodyParameters restriction** (Breaking, 13 Sept 2025): Remove page_id as possible parent for CreateDataSourceBodyParameters; only database_id now supported.
- **SDK data source parent update support** (New feature, 13 Sept 2025): JavaScript/TypeScript SDK dataSource.update now supports changing data source parent database.
- **SDK page locking support** (New feature, 13 Sept 2025): JavaScript/TypeScript SDK adds is_locked boolean parameter support on update page and database APIs.

### August 2025

- **API version 2025-09-03 multi-source databases** (Breaking, 26 Aug 2025): Major API version introduces separation of databases (containers) from data sources (tables) enabling multi-source databases.

### December 2024

- **Developer Terms security updates** (Other, 20 Dec 2024): Developer Terms revised to refine scope application and clarify prohibited API uses with new formatting section.

### September 2024

- **New API token prefix ntn_** (Other, 11 Sept 2024): Newly generated Public API tokens now use ntn_ prefix instead of secret_ prefix for improved security scanning compatibility.

### April 2024

- **in_trash property introduced** (Deprecation, 1 Apr 2024): New in_trash property added to indicate if pages/blocks/databases are in trash; deprecated archived field may be removed in future version.

### December 2023

- **File block naming support** (New feature, 10 Dec 2023): Support added for reading and writing names to file blocks in the public API.

## Other APIs we monitor

- [Airtable](https://seamless.engineering/api-changelog/airtable/)
- [Brevo](https://seamless.engineering/api-changelog/brevo/)
- [DATEV](https://seamless.engineering/api-changelog/datev/)
- [Discord](https://seamless.engineering/api-changelog/discord/)
- [Google Sheets](https://seamless.engineering/api-changelog/google-sheets/)
- [HubSpot](https://seamless.engineering/api-changelog/hubspot/)
- [Jira Cloud](https://seamless.engineering/api-changelog/jira/)
- [lexoffice](https://seamless.engineering/api-changelog/lexoffice/)
- [Linear](https://seamless.engineering/api-changelog/linear/)
- [Monday.com](https://seamless.engineering/api-changelog/monday/)
- [Personio](https://seamless.engineering/api-changelog/personio/)
- [Pinterest API](https://seamless.engineering/api-changelog/pinterest/)
- [Pipedrive](https://seamless.engineering/api-changelog/pipedrive/)
- [Salesforce](https://seamless.engineering/api-changelog/salesforce/)
- [Shopify](https://seamless.engineering/api-changelog/shopify/)
- [Slack](https://seamless.engineering/api-changelog/slack/)
- [Stripe](https://seamless.engineering/api-changelog/stripe/)
- [Xentral](https://seamless.engineering/api-changelog/xentral/)
- [Zendesk](https://seamless.engineering/api-changelog/zendesk/)

## Frequently asked questions

### Has the Notion API had breaking changes recently?

Yes: 1 breaking change and 0 deprecations in the last 90 days. The most recent is “Notion app links domain change to notion.com” from 15 July 2026.

### How often does the Notion API change?

Over the period on record, Notion published about 2 changelog entries a month. Most are additions; the breaking changes and deprecations are the ones to plan for.

### Where is the official Notion API changelog?

Notion publishes it at https://developers.notion.com/page/changelog. This page follows it daily and dates each entry.

### How do I get notified about Notion API changes?

Subscribe to this page's RSS feed (https://seamless.engineering/api-changelog/notion/rss.xml). If you would rather have someone act on them, we operate Notion integrations and handle changes like these before they reach production.

## Request a scoping call

We watch Notion because we run integrations on it. If one of yours depends on Notion, we can take it over: build it properly, operate it, and fix it when Notion changes, before your data is affected. Fixed-price scoping quote within 48 hours.

- Email: hello@seamless.engineering
- Contact form: https://seamless.engineering/#contact