Creates a new page in the specified database or as a child of an existing page.

If the parent is a database, the property values of the new page in the properties parameter must conform to the parent database's property schema.

If the parent is a page, the only valid property is title.

The new page may include page content, described as blocks in the children parameter.

📘

Blocks cannot be modified currently

Once a block is appended as a child of another block, it cannot be updated or deleted.

📘

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.

Errors

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

Returns a 400 or a 429 HTTP response if the request exceeds the request limits.

Language
Authentication
OAuth2