The Page object contains the property values of a single Notion page.

All pages have a parent. If the parent is a database, the property values conform to the schema laid out database's properties. Otherwise, the only property value is the title.

Page content is available as blocks. The content can be read using retrieve block children and appended using append block children.

📘

Properties marked with an * are available to integrations with any capabilities. Other properties require read content capabilities in order to be returned from the Notion API. For more information on integration capabilities, see the capabilities guide.

All pages

Property

Type

Description

Example value

object*

string

Always "page".

"page"

id*

string (UUIDv4)

Unique identifier of the page.

"45ee8d13-687b-47ce-a5ca-6e2e45548c4b"

created_time

string (ISO 8601 date and time)

Date and time when this page was created. Formatted as an ISO 8601 date time string.

"2020-03-17T19:10:04.968Z"

created_by

Partial User

User who created the page.

{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}

last_edited_time

string (ISO 8601 date and time)

Date and time when this page was updated. Formatted as an ISO 8601 date time string.

"2020-03-17T19:10:04.968Z"

last_edited_by

Partial User

User who last edited the page.

{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}

archived

boolean

The archived status of the page.

false

icon

File Object (only type of "external" is supported currently) or Emoji object

Page icon.

cover

File object (only type of "external" is supported currently)

Page cover image.

properties

object

Property values of this page.

If parent.type is "page_id" or "workspace", then the only valid key is title.

If parent.type is "database_id", then the keys and values of this field are determined by the properties of the database this page belongs to.

key string
Name of a property as it appears in Notion.

value object
See Property value object.

parent

object

The parent of this page. Can be a database, page, or workspace. Parent types are defined below.

url

string

The URL of the Notion page.

"https://www.notion.so/Avocado-d093f1d200464ce78b36e58a3f0d8043"

Database parent

The parent property is an object containing the following keys:

Property

Type

Description

Example values

type

string

Always "database_id".

"database_id"

database_id

string (UUIDv4)

The ID of the database that this page belongs to.

"b8595b75-abd1-4cad-8dfe-f935a8ef57cb"

Page parent

The parent property is an object containing the following keys:

Property

Type

Description

Example values

type

string

Always "page_id".

"page_id"

page_id

string (UUIDv4)

The ID of the page that this page belongs to.

"b8595b75-abd1-4cad-8dfe-f935a8ef57cb"

Workspace parent

A page with a workspace parent is a top-level page within a Notion workspace. The parent property is an object containing the following keys:

Property

Type

Description

Example values

type

string

Always "workspace".

"workspace"

workspace

boolean

Always true.

true