# Notion API-Changelog

Wir prüfen täglich den Entwickler-Changelog von Notion, weil wir produktive Integrationen auf der Notion API betreiben. Diese Seite listet die 72 Änderungen, die wir seit Beginn der Überwachung am 26. März 2026 erfasst haben, die neuesten zuerst. Die letzte erfolgreiche Prüfung war am 28. September 2026. Wir kümmern uns darum; bis dahin fehlen hier eventuell die neuesten Änderungen.

**Kurz gesagt:** 1 Breaking Change und 0 Deprecations in der Notion API in den letzten 90 Tagen. Zuletzt: „Notion app links domain change to notion.com“ (15. Juli 2026).

- [Offizieller Notion-Changelog](https://developers.notion.com/page/changelog)
- [RSS-Feed: Änderungen an der Notion API](https://seamless.engineering/api-changelog/notion/rss.xml)

## Änderungen an der Notion API

Die Einordnung erfolgt automatisch. Prüfen Sie die Notiz des Anbieters, bevor Sie Aufwand einplanen.

### Juli 2026

- **Per-tool access map in notion-fetch self** (Neue Funktion, 17. Juli 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** (Neue Funktion, 15. Juli 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 Change, 15. Juli 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** (Neue Funktion, 15. Juli 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** (Sonstiges, 14. Juli 2026): Notion MCP access tokens now last about eight hours instead of one hour.
- **Automatic retry of service_overload responses** (Fehlerbehebung, 8. Juli 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** (Neue Funktion, 8. Juli 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** (Neue Funktion, 8. Juli 2026): notion.asyncTasks.retrieve() and allow_async parameter enable asynchronous large markdown writes with polling.
- **Verify webhook signatures with one call** (Neue Funktion, 8. Juli 2026): New verifyWebhookSignature() helper in SDK v5.23.0 simplifies webhook authentication verification.
- **HTML blocks via the API** (Neue Funktion, 3. Juli 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** (Neue Funktion, 2. Juli 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** (Neue Funktion, 1. Juli 2026): databases.retrieve now returns the icon set in Notion UI, matching data source icon behavior.
- **Icon names and database icons** (Neue Funktion, 1. Juli 2026): Icon name field now accepts icon picker names like 'token' and 'star circle', and databases.retrieve now returns the UI icon.

### Juni 2026

- **Async page markdown writes** (Neue Funktion, 29. Juni 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** (Neue Funktion, 25. Juni 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** (Neue Funktion, 25. Juni 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** (Neue Funktion, 22. Juni 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** (Neue Funktion, 22. Juni 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** (Neue Funktion, 22. Juni 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** (Neue Funktion, 22. Juni 2026): Status property options now accept optional group field to assign options to 'To-do', 'In progress', or 'Complete' groups.
- **Workspace-level rate limits** (Sonstiges, 16. Juni 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** (Neue Funktion, 10. Juni 2026): Bots can now be assigned to people properties and referenced in user rich text mentions.
- **Unique access tokens per OAuth authorization** (Breaking Change, 8. Juni 2026): New public connections now mint fresh access_token and refresh_token for each OAuth authorization instead of reusing existing tokens.

### Mai 2026

- **Markdown page insertion positions** (Neue Funktion, 15. Mai 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** (Neue Funktion, 12. Mai 2026): New Developer portal provides single place to manage connections, Workers, and personal access tokens with workspace admin PAT management.
- **agent_id parent type** (Neue Funktion, 11. Mai 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** (Neue Funktion, 11. Mai 2026): New POST /v1/blocks/meeting_notes/query endpoint returns AI meeting notes with optional filters, sorts, and limits.

### April 2026

- **Pagination cursor improvements** (Fehlerbehebung, 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** (Fehlerbehebung, 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 Change, 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** (Sonstiges, 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** (Neue Funktion, 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** (Neue Funktion, 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** (Neue Funktion, 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** (Neue Funktion, 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** (Sonstiges, 2. Apr. 2026): Developer Terms updated with clarifications to scope, revisions to Feedback provision, and other minor changes.

### März 2026

- **Heading 4 block type** (Neue Funktion, 30. März 2026): heading_4 is now a supported block type alongside heading_1, heading_2, and heading_3.
- **Me relative filter for people properties** (Neue Funktion, 30. März 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** (Neue Funktion, 30. März 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** (Neue Funktion, 30. März 2026): Paragraph blocks that are direct children of tab blocks now support optional icon field when creating or updating tabs.
- **View API fixes** (Fehlerbehebung, 30. März 2026): Fixed percent-encoded property IDs in view filters, rejected width: 0 for columns, and fixed partial properties list behavior.
- **View API fixes** (Fehlerbehebung, 30. März 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** (Neue Funktion, 25. März 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** (Neue Funktion, 25. März 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** (Neue Funktion, 25. März 2026): Verification property on wiki database pages can now be set and updated via Create/Update page endpoints.
- **Status property support** (Neue Funktion, 19. März 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** (Neue Funktion, 19. März 2026): Status properties can now be created and updated through the API with custom options, previously read-only.
- **Views API launch** (Neue Funktion, 19. März 2026): Eight new endpoints for programmatic view management: create, retrieve, update, delete views; list views; and query views with pagination support.
- **Views API launch** (Neue Funktion, 19. März 2026): Eight new endpoints enable programmatic management of database views including create, retrieve, update, delete, list, and query operations.
- **Markdown content API improvements** (Neue Funktion, 11. März 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 Change, 11. März 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** (Neue Funktion, 11. März 2026): New MCP tools for creating and updating database views with full configuration support including filters, sorts, and layout-specific settings.
- **Template timezone parameter** (Neue Funktion, 11. März 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** (Neue Funktion, 2. März 2026): GET /v1/pages/:page_id/markdown endpoint now available to internal integrations, previously public-only.

### Februar 2026

- **AI meeting notes support** (Neue Funktion, 26. Feb. 2026): Markdown retrieval endpoint supports `include_transcript` parameter; new transcription block type for reading AI meeting notes metadata.
- **Markdown content API** (Neue Funktion, 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** (Neue Funktion, 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** (Neue Funktion, 26. Feb. 2026): JavaScript/TypeScript SDK now retries failed requests automatically with configurable backoff.

### Januar 2026

- **Data source templates API** (Neue Funktion, 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** (Neue Funktion, 15. Jan. 2026): New endpoint to list available templates for creating data sources.
- **Move page API** (Neue Funktion, 15. Jan. 2026): New endpoint to change the parent of an existing page.
- **Notion MCP tool consolidation and fixes** (Neue Funktion, 15. Jan. 2026): Tool consolidation removed notion-get-user, fixed delete bug with replace_content, and reduced context tokens.
- **Page erase_content parameter** (Neue Funktion, 15. Jan. 2026): Update page endpoint now supports erase_content parameter to remove content from pages.
- **Page position customization** (Neue Funktion, 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 Change, 13. Sept. 2025): Remove page_id as possible parent for CreateDataSourceBodyParameters; only database_id now supported.
- **SDK data source parent update support** (Neue Funktion, 13. Sept. 2025): JavaScript/TypeScript SDK dataSource.update now supports changing data source parent database.
- **SDK page locking support** (Neue Funktion, 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 Change, 26. Aug. 2025): Major API version introduces separation of databases (containers) from data sources (tables) enabling multi-source databases.

### Dezember 2024

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

### September 2024

- **New API token prefix ntn_** (Sonstiges, 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.

### Dezember 2023

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

## Weitere überwachte APIs

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

## Häufige Fragen

### Gab es zuletzt Breaking Changes in der Notion API?

Ja: 1 Breaking Change und 0 Deprecations in den letzten 90 Tagen. Die jüngste Änderung: „Notion app links domain change to notion.com“ vom 15. Juli 2026.

### Wie oft ändert sich die Notion API?

Im erfassten Zeitraum hat Notion rund 2 Changelog-Einträge pro Monat veröffentlicht. Die meisten sind Erweiterungen; einplanen sollte man vor allem die Breaking Changes und Deprecations.

### Wo finde ich den offiziellen Changelog der Notion API?

Notion veröffentlicht ihn unter https://developers.notion.com/page/changelog. Diese Seite verfolgt ihn täglich und datiert jeden Eintrag.

### Wie erfahre ich von Änderungen an der Notion API?

Abonnieren Sie den RSS-Feed dieser Seite (https://seamless.engineering/api-changelog/notion/rss.xml). Soll sich lieber jemand darum kümmern: Wir betreiben Notion-Integrationen und fangen solche Änderungen ab, bevor sie in Produktion ankommen.

## Scoping-Gespräch anfragen

Wir beobachten Notion, weil wir Integrationen darauf betreiben. Hängt eine Ihrer Integrationen an Notion, übernehmen wir sie: sauber gebaut, dauerhaft betrieben und angepasst, wenn Notion etwas ändert, bevor Ihre Daten betroffen sind. Festpreisangebot innerhalb von 48 Stunden.

- E-Mail: hello@seamless.engineering
- Kontaktformular: https://seamless.engineering/de/#contact