page/get

When to Use

• Sync freshness check: Before syncing a page's data to an external system, call page/get and compare last_edited_time against the last sync timestamp. Skip unchanged pages to avoid unnecessary writes.
• Workflow branching on property values: Retrieve a page to read its current Status or Priority property, then use an IfCondition node to branch the workflow based on the value.
• Archive guard: Before updating a page, check the archived field. If true, skip the update and log a warning — writing to an archived page will fail.
• URL extraction for notifications: Retrieve the url field and include it in an email or Slack message so recipients can navigate directly to the Notion page.
• Property audit: Fetch individual pages from a list to audit whether required properties (e.g., Assignee, Due Date) are set. Flag missing values for follow-up.

Configuration

Authentication

Operation Fields

Sample Configuration

{
  "resource": "page",
  "operation": "get",
  "AuthenticationMethod": "ApiToken",
  "ApiToken": "{{ $credentials.notionApiToken }}",
  "Page": "{{ $json.pageId }}",
  "Simplify": true
}

Validation Errors

Output

Success Port

Error Port

On failure the error port receives errorCode, message, and httpStatus. Handle NOTION_NOT_FOUND gracefully when page IDs come from user input or external systems that may reference deleted pages.

Sample Output

{
  "id": "b8c9d0e1-f2a3-4567-bcde-678901234567",
  "url": "https://www.notion.so/b8c9d0e1f2a34567bcde678901234567",
  "created_time": "2024-05-20T09:00:00.000Z",
  "last_edited_time": "2024-06-10T15:30:00.000Z",
  "archived": false,
  "icon": { "type": "emoji", "emoji": "📋" },
  "properties": {
    "Name": {
      "type": "title",
      "title": [{ "plain_text": "Build login page" }]
    },
    "Status": {
      "type": "select",
      "select": { "name": "In Progress" }
    },
    "Assignee": {
      "type": "people",
      "people": [{ "name": "Sarah Chen", "id": "user-uuid-1" }]
    },
    "Due": {
      "type": "date",
      "date": { "start": "2024-06-15" }
    }
  },
  "parent": {
    "type": "database_id",
    "database_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Expression Reference

Node Policies & GuardRails

Workflow Examples

Example 1 — Sync Freshness Gate

Before exporting a page's data to an external system, check whether it has been edited since the last sync.

// Step 1: page/get
{ "Page": "{{ $json.pageId }}", "Simplify": true }

// Step 2: IfCondition
// Condition: {{ $output.getPage.last_edited_time }} > {{ $vars.lastSyncTime }}
// True: proceed to export
// False: StopWorkflow (no changes)

Example 2 — Status-Gated Update

Read the current page status. Only proceed with the update if the page is not already marked "Done" and is not archived.

// Step 1: page/get { "Page": "{{ $json.pageId }}", "Simplify": true }
// Step 2: IfCondition
// Condition 1: {{ $output.getPage.archived }} === false
// Condition 2: {{ $output.getPage.properties.Status }} !== "Done"
// Both true: proceed to page/update
// Otherwise: log and stop

Example 3 — Notification with Page URL

After a trigger fires on a page, fetch the page to get its title and URL, then send a Slack alert to the assignee.

// Step 1: page/get { "Page": "{{ $trigger.pageId }}" }
// Step 2: user/get to resolve assignee Slack ID
// Step 3: Slack/postMessage
{
  "channel": "@{{ $json.assigneeSlackId }}",
  "text": "Task updated: {{ $output.getPage.properties.Name.title[0].plain_text }}\n{{ $output.getPage.url }}"
}