v3.0.0

What's Changed

This update, v2.3.0 → v3.0.0, is marked as a major version upgrade due to the Node minimum version increase to 18, as part of the change to use built-in fetch as the default in the Client constructor instead of node-fetch.

• Sync OpenAPI schema as of 2025-04-08 to src/api-endpoints.ts by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/558
  • Refactor common parameter shapes into new types: InternalFileRequest, ExternalFileRequest, and InternalOrExternalFileWithNameRequest
  • Support commenting on a non-page block in the Create Comment API by accepting a parent type of block_id
• Use isomorphic fetch by @sv2dev in https://github.com/makenotion/notion-sdk-js/pull/506
  • This updates the minimum Node engine version from 12 to 18.
• Small typo fixes in docs and example files
  • docs: fix incorrect example path in README by @R-jisu in https://github.com/makenotion/notion-sdk-js/pull/556
  • Update .env.example by @jtsmith1287 in https://github.com/makenotion/notion-sdk-js/pull/532
  • Update README.md with correct cd command by @crosskayla in https://github.com/makenotion/notion-sdk-js/pull/493

Full Changelog: https://github.com/makenotion/notion-sdk-js/compare/650d23bd94c1cd9a4179fcbea25be617e2f5a7e5...v3.0.0

View this version on NPM: https://www.npmjs.com/package/@notionhq/client/v/3.0.0

New Contributors

• @sv2dev made their first contribution in https://github.com/makenotion/notion-sdk-js/pull/506
• @R-jisu made their first contribution in https://github.com/makenotion/notion-sdk-js/pull/556
• @jtsmith1287 made their first contribution in https://github.com/makenotion/notion-sdk-js/pull/532
• @crosskayla made their first contribution in https://github.com/makenotion/notion-sdk-js/pull/493