@notionhq/client 5.0.0

v5.0.0

on Node.js NPM

What's Changed

Major changes and highlights from v4.0.2 to v5.0.0.

⚡️ Major API and SDK updates

• Added support for multiple data sources
  • Prepared the SDK for Notion API version 2025-09-03, introducing notion.dataSources.* endpoints to manage databases at the data source level and repurposing notion.databases.* endpoints for the database container. #600 #601 #602 #603 #607 #609
• Removed support for `notion.databases.list
  • The list databases method has been removed, since this endpoint has been deprecated & unsupported since 2022-02-22, and v5 of the SDK is tailored toward 2025-09-03 #600
• Added support for verification filters for data sources
  • Added verification filter property to queryDataSources API shape #604

📝 API shape and type improvements

• Richer API error details
  • SDK now surfaces the optional additional_data field in API error responses for better diagnostics. #603
• API schema syncs
  • DataSourceObjectResponse["parent"] now supports the data_source_id variant.
  • Search filter enum updated from page | database to page | data_source.
  • Typechecking added for all examples/ projects in CI. #602

🧩 Examples and internal maintenance

• Examples directory
  • Migrated all examples/ to TypeScript and committed missing build files. #603 #600
• CI improvements
  • All examples are now typechecked as part of continuous integration. #602
• Other
  • Added Copilot instructions file for repo #610

🛠 Miscellaneous fixes

• Documentation
  • Updated the minimum recommended TypeScript version in the README after a dependency upgrade. #598
• Patch releases
  • Version bumps and lockfile updates to keep publish and infra consistent. #596 #597

New Contributors

• @hallie made their first contribution in #604

Links

• Full Changelog: f12b584...v5.0.0
• Upgrade Guide: https://developers.notion.com/docs/upgrade-guide-2025-09-03
• NPM Package: https://npmjs.com/package/@notionhq/client/v/5.0.0