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.


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.


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.