Notion integration

What it does

The Notion integration lets your agency keep client knowledge bases, CRMs, and project trackers in sync with the rest of your stack. Connect a client workspace once and you can query databases, create and update pages, append rich content blocks, search across everything the client has shared with you, and start workflows when a database row changes.

Connect a Notion account

1. Open your workspace in TaskJuice and navigate to Connections.
2. Choose Notion and click Connect.
3. Sign in to Notion as your client (or have them complete the connect step in their workspace).
4. Select which pages and databases to share with TaskJuice. The integration can only see the resources your client explicitly shares.
5. TaskJuice returns you to the workspace with the connection ready to use in any workflow.

To revoke access, the workspace owner can remove the integration from Notion workspace settings.

Triggers

• notion/database-item-changed polls a chosen Notion database and emits one activation per cycle wrapping every page whose last_edited_time has advanced since the previous run. Drop a Loop node downstream to process each page individually, or feed the items array straight into a digest.

Actions

• notion/query-database queries a database with optional filter and sort expressions and returns the matching pages with cursor pagination.
• notion/create-page creates a new page in a database (or under a parent page) with properties, optional content blocks, icon, and cover.
• notion/update-page updates a page's properties and can archive or restore it.
• notion/retrieve-page fetches a single page by ID.
• notion/append-block-children appends rich content blocks to a page or a parent block, optionally after a specific block ID.
• notion/search searches across every page and database your client has shared with the integration.

Known limitations

• Notion does not publish webhooks. New and edited pages are surfaced via polling, so changes appear on the configured poll interval (default five minutes) rather than instantly.
• Notion enforces an average rate limit of roughly three requests per second per integration. When a 429 is returned, TaskJuice surfaces it as a retryable rate-limit error and respects the recommended backoff.
• The integration can only read or write resources that have been explicitly shared with it in Notion. Pages outside the shared scope return 404 even when they exist.
• Notion properties payloads follow the provider's per-type shape (title, rich_text, select, relation, and so on). Use a Notion property reference handy when authoring Create Page and Update Page actions.