❗️

Deprecated as of version 2025-09-03

This page describes the API for versions up to and including2022-06-28. In the new2025-09-03 version, the concepts of databases and data sources were split up, as described inUpgrading to 2025-09-03.

Refer to the new APIs instead:

• Create a database
• Create a data source

Creates a database as a subpage in the specified parent page, with the specifiedproperties schema. Currently, the parent of a new database must be a Notion page or awiki database.

📘

Integration capabilities

This endpoint requires an integration to have insert content capabilities. Attempting to call this API without insert content capabilities will return an HTTP response with a 403 status code. For more information on integration capabilities, see thecapabilities guide.

🚧

Limitations

Creating newstatus database properties is currently not supported.

Errors

Returns a 404 if the specified parent page does not exist, or if the integration does not have access to the parent page.

Returns a 400 if the request is incorrectly formatted, or a 429 HTTP response if the request exceeds therequest limits.

Note: Each Public API endpoint can return several possible error codes. See theError codes section of the Status codes documentation for more information.