Browse documentation

Integrations

Notion

Create pages, update pages, query databases/data sources, and search.

Automation buildersAdministratorsIntermediateAvailable

What this guide covers

  • A Notion workspace authorization that can access the pages and databases explicitly shared with the connection.
  • 4 supported workflow actions.
  • Notion limits the connection to content that was shared during or after authorization. A successful connection does not automatically expose every workspace page.
  • Property payloads must match the target Notion schema.

What Notion connects

A Notion workspace authorization that can access the pages and databases explicitly shared with the connection.

Create pages, update pages, query databases/data sources, and search.

Prerequisites and permissions

  1. A Notion workspace and permission to connect it
  2. Target pages or databases shared with the Yanola connection
  3. Property names and values matching the destination schema

Connect and configure

  1. Open the intended Agent Project → Integrations.
  2. Find Notion and select Connect.
  3. Complete authorization with the correct external identity.
  4. Confirm the returned connection status is active.
  5. In the workflow builder, add App Action.
  6. Select Notion, choose one supported action, select the connection, and complete the fields Yanola displays.
  7. Save and test with controlled data before activation.

Supported actions

Notion workflow actions
Action IDWhat it does
create_pageCreate a Notion page in a page or database.
update_pageUpdate Notion page properties or archive status.
query_databaseQuery a Notion database or data source.
searchSearch pages and databases accessible to the connection.

Example workflow

Create a support-escalation page containing the customer, category, summary, and conversation reference.

Notion pattern
text
Workflow Trigger → Validate inputs → App Action (Notion) → Condition → Notify or End Flow

Reconnection and token expiration

  1. Open Integrations when a workflow reports a missing, expired, revoked, or error connection.
  2. Select Reconnect for Notion.
  3. Authorize the intended identity again.
  4. Validate access to the exact resource used by the workflow.
  5. Retest every dependent App Action.

Troubleshooting

Notion troubleshooting
SymptomWhat to check
Connection is expired, revoked, or errorReconnect from Integrations and complete provider consent.
Action cannot find a resourceGrant the connected identity access and use the exact provider ID.
Action input is rejectedMatch the action-specific fields and data types shown in the node.
Test and live behavior differCheck provider environment, current permissions, external rate limits, and live data.

Limitations and security

Property payloads must match the target Notion schema.

The connection cannot access a page or database that has not been shared with it.