Notion Node

Overview

The Notion Node is a comprehensive integration component that automates content management and page operations with Notion workspaces. This node enables both trigger-based workflows that respond to Notion events and action-based operations for creating, updating, and managing Notion pages, comments, and content.

This node supports both Event Trigger and Action modes, providing flexible integration capabilities for Notion workflows.

Features

Prerequisites

Before using Notion Node, ensure the following:

• Notion Account: Access to a Notion account with appropriate permissions.
• Page Access: Read/write permissions on target Notion pages and databases.

Setup

Step 1: Set Up Notion Credentials

Please refer to the Notion Integration documentation (opens in a new tab) to complete the setup and obtain the necessary credentials.

Step 2: Set Up Lamatic Flow

For Trigger Node:

1. Add Notion Node: Drag the Notion node to your flow as a trigger
2. Setup Notion Credentials: Setup your Notion Credential

For Action Node:

1. Add Notion Node: Drag the Notion node to your flow as an action
2. Setup Notion Credentials: Setup your Notion Credential
3. Select Action: Choose the desired action type
4. Configure Parameters: Set up action-specific parameters

Configuration Reference

Event Trigger Configuration

1. Setup Notion Credentials: Setup your Notion Credential
2. Select Event Types: Choose from available event types:
   • All Page Events
   • New Comment
   • New Page
   • Page Added to Page
   • Page Updated

Action Configuration

Configure the Notion node by selecting the desired action and providing the necessary parameters.

Available Actions

1. Add Content to Page

Adds content to an existing Notion page.

2. Archive Page

Archives a specific Notion page.

3. New Comment

Creates a new comment on a Notion page.

4. New Page

Creates a new page in a Notion workspace.

5. Page Added to Page

Handles when a page is added to another page.

6. Page Updated

Updates an existing Notion page.

Low-Code Example

Event Trigger Example

triggerNode:
  nodeId: triggerNode_1
  nodeType: notionNode
  nodeName: Notion
  values:
    credentials: ''
    action: ''
    database_id: ''
    page_id: ''
  modes: {}

Action Node Example

- nodeId: notionNode_983
    nodeType: notionNode
    nodeName: Notion
    values:
      credentials: ''
      action: ''
      pageId: ''
      databaseId: ''
      blockId: ''
      content: ''
      title: ''
      parent: ''
      parentDatabase: ''
      properties: ''
      query: ''
      commentText: ''
      commentId: ''
      userId: ''
      rowId: ''
      propertyId: ''
      getAll: false
      getDatabases: false
      getPages: false
      queryFetchData: ''
    modes: {}
    needs:
        - triggerNode

Output Schema

Event Trigger Output

The Notion trigger node outputs data in the following format when triggered by a Notion event:

{
  "page_id": "page_id_here",
  "event_type": "page_updated",
  "data": {
    "title": "Page Title",
    "content": "Page content",
    "properties": {
      "Status": "Active"
    }
  },
  "metadata": {
    "triggered_at": "2024-01-01T12:00:00Z",
    "integration_id": "integration_123"
  }
}

Action Node Output

Action nodes return data based on the specific action performed:

New Page Output

{
  "id": "page_id_here",
  "title": "New Page Title",
  "created_time": "2024-01-01T12:00:00Z",
  "last_edited_time": "2024-01-01T12:00:00Z"
}

Add Content to Page Output

{
  "page_id": "page_id_here",
  "content_added": true,
  "updated_time": "2024-01-01T12:00:00Z"
}

Troubleshooting

Common Issues

Debugging

• Check Lamatic Flow logs for detailed error messages
• Verify Notion integration token permissions and validity
• Test integration token using Notion's API documentation
• Validate page IDs exist and are accessible
• Confirm webhook URL is reachable from Notion
• Monitor Notion integration logs for trigger issues
• Test with simple operations before complex workflows
• Check Notion API rate limits and implement appropriate delays

Best Practices

• Use specific page IDs when referencing Notion pages
• Implement error handling for API rate limits
• Test webhook endpoints before deploying integrations
• Use appropriate content formats for Notion blocks
• Regularly monitor integration token permissions
• Implement retry logic for failed API calls
• Use efficient content structures for large pages
• Keep content payloads within Notion's size limits
• Test integrations with sample data before production use

Example Use Cases

Content Management Workflows

• Documentation Automation: Automatically create and update documentation pages
• Project Management: Sync project updates and task management
• Knowledge Base: Maintain and organize knowledge base content
• Meeting Notes: Automate meeting note creation and organization

Automation Workflows

• Form Submissions: Process form data and create Notion pages
• Email Integration: Create pages from incoming emails
• Calendar Integration: Sync events and create meeting pages
• Social Media Monitoring: Track mentions and create engagement pages

Data Processing Workflows

• Content Validation: Validate and clean incoming content before storage
• Content Transformation: Transform content formats for different systems
• Reporting: Generate reports from Notion data
• Backup and Archival: Automate content backup and archival processes