Create a database and its initial data source.
Creates a database as a subpage in the specified parent page, or as a private page at the workspace level, with the specified properties schema set on its initial_data_source. Currently, the parent of a new database must be a Notion page (page_id type) or a wiki database.
Use this endpoint to create a database, its first data source, and its first table view, all in one API call. Then, if you want to add a second data source, use the Create a data source API with a version of at least 2025-09-03, and provide the database_id as the id returned by the database create response.
For a complete reference on what properties are available, see Data source properties. After creating the database, to update one of its child data sources' properties, use the Update a data source API.
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 the capabilities guide.
Limitations
Creating new
statusdatabase 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 the request limits.
Note: Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.