Creates a new page in a database, as a child of an existing page, or in a workspace.
Method Signature notion . pages . create ( args : CreatePageParameters ): Promise < PageObjectResponse | PartialPageObjectResponse >
Parameters The parent location where the page will be created. Can be a database, page, or workspace. The ID of the parent database (with or without dashes)
The ID of the parent page (with or without dashes)
Set to true to create the page in the workspace root
Property values for the new page. The required properties depend on the parent database schema. Each property value is keyed by the property name and includes a type field. Array of rich text objects for title properties
Array of rich text objects for text properties
Numeric value for number properties
Select option with name or id
Date object with start and optional end and time_zone
Boolean value for checkbox properties
Array of user objects with id fields
Array of file objects (external or uploaded)
Array of relation objects with id fields
Status option with name or id
Page icon. Can be an emoji, external URL, file upload, or custom emoji. A single emoji character (e.g., ”📄”)
External file with url property
File upload with id property (must have status uploaded)
Page cover image. External file with url property
File upload with id property (must have status uploaded)
Array of block objects to add as the page’s initial content. Mutually exclusive with content and markdown.
Array of block objects to add as the page’s initial content. Mutually exclusive with children and markdown.
Page content as Notion-flavored Markdown. Mutually exclusive with content and children.
Template to apply to the page. One of: none, default, template_id
ID of the template to use (when type is template_id)
Position where the page should be inserted. One of: after_block, page_start, page_end
Block reference with id (when type is after_block)
Bearer token for authentication. Overrides the client-level authentication.
Response The ID of the newly created page
ISO 8601 timestamp when the page was created
ISO 8601 timestamp when the page was last edited
Whether the page is 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 if the page has been published to the web
Information about the page’s parent
Property values of the page
User who created the page
User who last edited the page
Examples Create a Page in a Database const page = await notion . pages . create ({ parent: { database_id: "897e5a76-ae52-4b48-9fdf-e71f5945d1af" , }, properties: { Name: { title: [ { text: { content: "My New Page" , }, }, ], }, Status: { status: { name: "In Progress" , }, }, Priority: { select: { name: "High" , }, }, }, }) console . log ( "Created page with ID:" , page . id )
Create a Page with Content const page = await notion . pages . create ({ parent: { database_id: "897e5a76-ae52-4b48-9fdf-e71f5945d1af" , }, properties: { Name: { title: [ { text: { content: "Meeting Notes" , }, }, ], }, }, children: [ { heading_1: { rich_text: [ { text: { content: "Agenda" , }, }, ], }, }, { paragraph: { rich_text: [ { text: { content: "Discuss project timeline and deliverables." , }, }, ], }, }, ], })
Create a Page with Markdown const page = await notion . pages . create ({ parent: { page_id: "b55c9c91-384d-452b-81db-d1ef79372b75" , }, properties: { title: [ { text: { content: "Documentation" , }, }, ], }, markdown: `# Getting Started Welcome to our documentation! ## Installation \`\`\` bash npm install @notionhq/client \`\`\` ## Usage Initialize the client with your API token. ` , })
Create a Child Page const childPage = await notion . pages . create ({ parent: { page_id: "b55c9c91-384d-452b-81db-d1ef79372b75" , }, properties: { title: [ { text: { content: "Subpage Title" , }, }, ], }, icon: { emoji: "📝" , }, })
Create a Page with Multiple Properties const page = await notion . pages . create ({ parent: { database_id: "897e5a76-ae52-4b48-9fdf-e71f5945d1af" , }, properties: { Name: { title: [ { text: { content: "Project Task" , }, }, ], }, "Due Date" : { date: { start: "2026-03-15" , end: "2026-03-20" , }, }, Assignee: { people: [ { id: "d40e767c-d7af-4b18-a86d-55c61f1e39a4" , }, ], }, Tags: { multi_select: [ { name: "urgent" }, { name: "feature" }, ], }, Completed: { checkbox: false , }, }, cover: { external: { url: "https://images.unsplash.com/photo-1484480974693-6ca0a78fb36b" , }, }, })
See Also 