n8n

How to Sync Notion Workflow Documentation?

Keep your n8n workflows tracked in Notion without manual updates. Every 15 minutes, the system scans for tagged workflows and records their status in a Notion database. Great for teams that run many automations and want a single source of truth.

A schedule trigger runs every 15 minutes. It calls the n8n API to get all workflows with the tag sync-to-notion. A Set step prepares key fields like name, URL, active state, created and updated dates, and a unique env id. An HTTP Request queries a Notion database for a matching env id. A Map step organizes the data, and an If check decides whether to add a new page or update an existing one. Notion nodes then create or update the database page, so records stay clean and current without duplicates.

To put this in place, you need n8n API access and a Notion integration with a database that has matching fields. Add the tag to any workflow you want tracked. Expect faster reporting, fewer mistakes, and a clear view of automation health. Useful for internal documentation, audits, onboarding, and incident reviews.

What are the key features?

  • Scheduled sync every 15 minutes to keep Notion current.
  • Pulls only workflows with the sync-to-notion tag using the n8n API.
  • Prepares fields like name, URL, active state, created and updated dates, and env id with Set nodes.
  • Queries a Notion database by env id using an HTTP Request with the Notion-Version header.
  • If routing decides whether to create a new Notion page or update an existing one.
  • Notion nodes add new database pages or update properties without duplicates.
  • Map step bundles the payload so the same data feeds both add and update paths.

What are the benefits?

  • Reduce manual catalog updates from 60 minutes a week to under 5 minutes
  • Automate 100% of status tracking for tagged workflows
  • Improve data quality by up to 90% by removing copy and paste errors
  • Connect Notion and n8n so records stay in sync without extra steps
  • Scale to hundreds of workflows with the same 15 minute schedule

How do you set it up?

  1. Import the template into n8n: Create a new workflow in n8n > Click the three dots menu > Select 'Import from File' > Choose the downloaded JSON file.
  2. You'll need accounts with Notion and n8n. See the Tools Required section above for links to create accounts with these services.
  3. In Notion, create a database for tracking workflows with these properties: env id as text, isActive (dev) as checkbox, URL (dev) as URL, Workflow created at as date, Workflow updated at as date, Error workflow setup as checkbox.
  4. Share the Notion database with your Notion integration so it has read and write access. Copy the database ID from the Notion URL.
  5. Open the HTTP Request node that queries Notion and replace the database ID in the URL with your own. Keep the Notion-Version header as shown.
  6. Open both Notion nodes that add or update pages and set the database or page references to your Notion database. Make sure property names match your Notion fields exactly.
  7. Set up Notion credentials in n8n Cloud: double click the Notion nodes, choose 'Create new credential', then follow the on screen instructions and paste your Notion internal integration token.
  8. Set up the n8n API credential: double click the n8n API node, choose 'Create new credential', then follow the on screen steps using your n8n personal access token or admin auth.
  9. Update the instance URL value where noted in the Set node or variables. Use your n8n base URL so the workflow links open correctly.
  10. Add the tag sync-to-notion to one or two workflows you want to track. Run once manually to seed Notion and confirm pages are created.
  11. Check Notion to verify the name, URL, active state, and dates filled correctly. Edit a workflow name or active state, then wait for the next 15 minute run to confirm updates apply.
  12. If nothing syncs, confirm the tag matches exactly, the Notion database is shared with the integration, and the database ID is correct. If duplicates appear, make sure env id is stable and unique per workflow.

Tools Required

$24 / mo or $20 / mo billed annually to use n8n in the cloud. However, the local or self-hosted n8n Community Edition is free.

Notion

Sign up

Free plan: $0 per member / mo (Public API included)

n8n API

Sign up

Community Edition (self-hosted): $0 (public REST API available). Cloud Starter: $20 / mo billed annually ($24 monthly); API unavailable during free trial.

Credits:
Nik

Similar Templates

Join Futurise to access 1,200+ automation templates

Get instant access to ready-made automation workflows for n8n, Make.com, AI agents, and more. Download, customise, and deploy in minutes.