Notion Action Block
The Notion Action Block reads and writes your Notion workspace from a workflow — query databases, create and update pages, append content blocks, add comments, and manage users. 20 operations are available.
Living Knowledge Base: Turn Notion into the destination for your automations — log leads into a database, append meeting notes to a page, or archive finished items.
Key Features
- 20 Operations across databases, pages, blocks, comments, and users
- Database Queries: Filter and sort database items with Notion's JSON filter syntax
- Page Building: Create pages with properties and append rich content blocks
- Pagination Built In: Page size, start cursor, and a max-items cap for large databases
- Variable Support: Every field accepts
{{variables}}from earlier blocks
Operations
| Group | Operations |
|---|---|
| Databases | Get Database, Query Database, List Database Items, Create Database, Update Database |
| Pages | Create Page, Update Page, Get Page, Search Pages, Archive Page, Duplicate Page, Get Page Property |
| Blocks | Get Block, Append Block, Update Block, Delete Block |
| Comments | Add Comment, Get Comments |
| Users | Get User, List Users |
Configuration
| Parameter | Used by | Description |
|---|---|---|
| Database ID | Database operations | The 32-character id from the database URL |
| Page ID | Page operations | The id from the page URL |
| Block ID | Block operations | The id of a content block |
| Filter / Sorts (JSON) | Query Database | Notion filter and sort objects |
| Properties (JSON) | Create/Update Page, Create Database | Page property values or database schema |
| Content (JSON/rich text) | Append/Update Block | The block content to write |
| Title | Create Database, Duplicate Page | Plain-text title |
| Parent Page ID | Create Database, Duplicate Page | Where the new database or copy is created |
| Comment Text / Discussion ID | Comments | The comment body, or a discussion to reply into |
| Page Size / Start Cursor / Max Items | List operations | Pagination controls (page size 1–100) |
Connecting Notion
The block uses a Notion internal integration:
- Go to notion.so/my-integrations (opens in a new tab) and click New integration.
- Give it a name, pick your workspace, and set the capabilities you need (read, insert, and update content).
- Copy the Internal Integration Token (starts with
ntn_orsecret_). - In the Notion block settings, add a new connection and paste the token.
- Share your pages with the integration: open each page or database in Notion, click the ··· menu → Connections (or "Add connections") → select your integration. Child pages inherit access from their parent.
The most common error is "object not found" — it usually means the page or database was never shared with the integration. Notion integrations can only see content that has been explicitly connected to them.
Output
The Notion API response is stored as the block's output. Reference fields downstream with {{blockId.field}} — for example {{blockId.results}} for the items returned by Query Database, or {{blockId.id}} for a newly created page.
Example: Log new leads into a database
- Webhook Trigger — your landing page sends each new lead.
- Notion (Create Page) — creates an item in the "Leads" database, mapping name, email, and source into database properties (JSON).
- Notion (Add Comment) — adds a comment with the raw form payload for context.
- Slack — notifies the sales channel with the new page's URL.