Notion — Input & Output

Output Ports

Port	Description
success	The Notion API call completed successfully. Output fields are populated and available to downstream nodes.
error	The API call failed. Common causes: invalid API token, resource not shared with integration (403), invalid page/database ID (404), property type mismatch, or malformed block JSON.

Page Object (page/get Output)

Field	Type	Description
`id`	string	The page's UUID, usable as `PageId` in subsequent operations.
`url`	string	Direct URL to the page in Notion. Share this in notifications for quick access.
`created_time`	string	ISO 8601 timestamp of when the page was created.
`last_edited_time`	string	ISO 8601 timestamp of the most recent edit.
`archived`	boolean	`true` if the page has been archived.
`parent`	object	Parent object — either `{"database_id": "..."}` for database pages or `{"page_id": "..."}` for standalone pages.
`properties`	object	All property values for the page. When `Simplify=true`, this is a flat key-value map. When `Simplify=false`, uses the full Notion API property format.
`icon`	object	Page icon — either `{"type":"emoji","emoji":"📋"}` or `{"type":"external","external":{"url":"..."}}`.

database/query Results Format

Field	Type	Description
`results`	array	Array of page objects matching the query filter. Each element is a full page object (see Page Object schema above).
`next_cursor`	string	Pagination cursor for the next page of results. Pass as `StartCursor` in the next call. `null` when no more results exist.
`has_more`	boolean	`true` when additional pages of results are available beyond the current response.

Example: database/query Response (Simplified)

{
  "results": [
    {
      "id": "page-uuid-0001",
      "url": "https://www.notion.so/page-uuid-0001",
      "created_time": "2026-05-01T09:00:00.000Z",
      "last_edited_time": "2026-05-22T16:45:00.000Z",
      "archived": false,
      "properties": {
        "Name":     "Design homepage redesign",
        "Status":   "In Progress",
        "Due Date": "2026-06-01",
        "Assignee": "Sarah Chen",
        "Priority": "High",
        "Done":     false
      }
    },
    {
      "id": "page-uuid-0002",
      "url": "https://www.notion.so/page-uuid-0002",
      "created_time": "2026-05-03T11:30:00.000Z",
      "last_edited_time": "2026-05-23T10:00:00.000Z",
      "archived": false,
      "properties": {
        "Name":     "Fix checkout flow validation",
        "Status":   "In Progress",
        "Due Date": "2026-05-30",
        "Assignee": "James Lee",
        "Priority": "Critical",
        "Done":     false
      }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Supported Block Types

The following block types can be used in the Blocks parameter for database/createPage, page/createStandalone, and block/appendChildren:

Block Type	JSON Example
`paragraph`	`{"object":"block","type":"paragraph","paragraph":{"rich_text":[{"text":{"content":"Body text here"}}]}}`
`heading_1`	`{"object":"block","type":"heading_1","heading_1":{"rich_text":[{"text":{"content":"H1 Title"}}]}}`
`heading_2`	`{"object":"block","type":"heading_2","heading_2":{"rich_text":[{"text":{"content":"Section Title"}}]}}`
`heading_3`	`{"object":"block","type":"heading_3","heading_3":{"rich_text":[{"text":{"content":"Sub-section"}}]}}`
`bulleted_list_item`	`{"object":"block","type":"bulleted_list_item","bulleted_list_item":{"rich_text":[{"text":{"content":"List item"}}]}}`
`numbered_list_item`	`{"object":"block","type":"numbered_list_item","numbered_list_item":{"rich_text":[{"text":{"content":"Step 1"}}]}}`
`to_do`	`{"object":"block","type":"to_do","to_do":{"rich_text":[{"text":{"content":"Task"}}],"checked":false}}`
`toggle`	`{"object":"block","type":"toggle","toggle":{"rich_text":[{"text":{"content":"Click to expand"}}]}}`
`code`	`{"object":"block","type":"code","code":{"rich_text":[{"text":{"content":"console.log('hello')"}}],"language":"javascript"}}`
`image`	`{"object":"block","type":"image","image":{"type":"external","external":{"url":"https://example.com/img.png"}}}`
`divider`	`{"object":"block","type":"divider","divider":{}}`
`callout`	`{"object":"block","type":"callout","callout":{"rich_text":[{"text":{"content":"Important note"}}],"icon":{"emoji":"⚠️"}}}`

user/get Output

Field	Type	Description
`id`	string	User's Notion UUID. Use this in `people` property values.
`name`	string	Display name of the user.
`email`	string	User's email address. Available for workspace members.
`avatarUrl`	string	URL to the user's profile photo.
`type`	string	`"person"` for human users or `"bot"` for integration bots.

Use {{ nodes.queryTasks.output.results }} to iterate over database query results in a Loop node. Reference individual simplified property values with {{ nodes.getPage.output.properties.Status }}. Share the page URL in downstream notifications with {{ nodes.createTask.output.url }}.