Use this API to create a new page as a child of an existing page or data source.
page_id or data_source under the parent parameter to create a page under an existing page, or data source, respectively.
There is a 3rd option, available only for bots of public integrations: creating a private page at the workspace level. To do this, omit the parent parameter, or provide parent[workspace]=true. This can be useful for quickly creating pages that can then be organized manually in the Notion app later, helping you get to your life’s work faster.
For internal integrations, a page or data source parent is currently required in the API, because there is no one specific Notion user associated with them that could be used as the “owner” of the new private page.
title is the only valid property in the properties body parameter.
If the new page is a child of an existing data source, the keys of the properties object body param must match the parent data source’s properties.
children option. To add content to a page after creating it, use the Append block children endpoint.
Templates: As an alternative to building up page content manually, the template body parameter can be used to specify an existing data source template to be used to populate the content and properties of the new page.
When omitted, the default is template[type]=none, which means no template is applied. The other options for template[type] are:
default: Apply the data source’s default template.
template_id: Provide a specific template_id to use as the blueprint for your page.
template[template_id], we recommend only using pages that are configured as actual database templates under the same data source as the parent of your new page to make sure that page properties can get merged in correctly.children parameter is not allowed. The page is returned as blank initially in the API response, and then Notion’s systems apply the template asynchronously after the API request finishes. For more information, see our full guide on creating pages from templates.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The API version to use for this request. The latest version is 2025-09-03.
2025-09-03 100100The page object type name.
"page"The ID of the page.
Date and time when this page was created.
Date and time when this page was last edited.
Whether the page has been archived.
Whether the page is in trash.
Whether the page is locked from editing in the Notion app UI.
The URL of the Notion page.
The public URL of the Notion page, if it has been published to the web.
Information about the page's parent.
Property values of this page.
Page icon.
Page cover image.
User who created the page.
User who last edited the page.