See llms.txt for all machine-readable content.

Matrix and Notion integration

Save yourself the work of writing custom integrations for Matrix and Notion and use n8n instead. Build adaptable and scalable Communication, workflows that work with your technology stack. All within a building experience you will love.

How to connect Matrix and Notion

Create a new workflow and add the first step

In n8n, click the "Add workflow" button in the Workflows tab to create a new workflow. Add the starting point – a trigger on when your workflow should run: an app event, a schedule, a webhook call, another workflow, an AI chat, or a manual trigger. Sometimes, the HTTP Request node might already serve as your starting point.

Matrix and Notion integration: Create a new workflow and add the first step

Score and route qualified leads to Notion and Matrix

Lead Scoring Pipeline – Matrix + Notion This workflow automatically enriches incoming form leads, applies a customizable scoring model, then routes high-value prospects to a Notion CRM database and a Matrix channel for instant sales notification. It streamlines lead qualification by combining third-party enrichment APIs, conditional logic, and asynchronous batching—eliminating manual research and ensuring your sales team focuses on the best opportunities. Pre-conditions/Requirements Prerequisites n8n instance (self-hosted or n8n cloud) ScrapeGraphAI community node installed Matrix community node installed Notion Integration (internal integration or Notion OAuth) Active third-party enrichment/validation APIs (e.g., Clearbit, Hunter, Kickbox) for scoring data A Notion database set up as your “Leads” table with fields: Name, Email, Company, Score, Status, Enrichment Required Credentials ScrapeGraphAI API Key – For optional web-scraping based enrichment Notion OAuth2 / Integration Token – To create & update pages in your CRM database Matrix Username & Password – For sending room messages (Optional) Third-party API Keys – Clearbit, Hunter, etc. Additional Setup Requirements | Setting | Example / Notes | |---------------------------------|----------------------------------------------------------| | Notion Database ID | 8f3d49e8c8f74e6f9d32e8e2bf7c1c46 | | Matrix Room ID | !aBcDeFgHiJ:matrix.org | | Scoring Threshold (env var) | LEAD_SCORE_MIN=70 | | Batch Size | SPLIT_IN_BATCHES=10 (controls parallel requests) | | Webhook URL for form submission | https://your-n8n-instance/webhook/leads | How it works This workflow automatically enriches incoming form leads, applies a customizable scoring model, then routes high-value prospects to a Notion CRM database and a Matrix channel for instant sales notification. It streamlines lead qualification by combining third-party enrichment APIs, conditional logic, and asynchronous batching—eliminating manual research and ensuring your sales team focuses on the best opportunities. Key Steps: Schedule / Webhook Trigger: Starts on a schedule (daily) or via a form-submission webhook. Split in Batches: Processes leads in manageable chunks to avoid rate limits. HTTP Requests: Calls enrichment APIs (Clearbit, Hunter, etc.) to retrieve firmographic & technographic data. Code (Scoring Logic): Calculates a numeric lead score using weighted criteria (industry, employee count, email validity, etc.). If Node (Qualification): Checks if the computed score meets or exceeds the defined threshold. Notion Node: Inserts or updates the qualified lead record in your Notion CRM database. Matrix Node: Sends a rich-text message to the sales room with lead details and score. Wait + Merge: Handles asynchronous API limits and merges enrichment data back into the main flow. Set up steps Setup Time: 15-25 minutes Clone the template in your n8n instance or import the JSON. Set environment variables (LEAD_SCORE_MIN, SPLIT_IN_BATCHES, API keys) in n8n Settings → Variables. Configure the Webhook/Schedule Trigger Webhook: copy the URL to your form provider Schedule: set cron (e.g., every hour). Update HTTP Request nodes with your enrichment API endpoints & headers. Map Notion fields: open the Notion node → choose your connection → select your Leads database → map data pins (Name, Email, etc.). Enter Matrix credentials & Room ID in the Matrix node. Adjust scoring weights in the Code node (weights object) to match your ICP (Ideal Customer Profile). Execute the workflow once with test data, verify Notion rows and Matrix messages. Activate the workflow and monitor via n8n’s execution list. Node Descriptions Core Workflow Nodes: Schedule Trigger / Webhook – Initiates the workflow on time-based interval or form submission. SplitInBatches – Limits API calls to avoid hitting rate caps. HTTP Request (Enrichment) – Queries external services for company, domain, and email data. Set (Normalize) – Formats API responses for scoring. Code (Score Calculator) – JavaScript that assigns points based on business rules. If (Score ≥ Threshold?) – Branches leads into “Qualified” or “Discard” paths. Notion (Create/Update Page) – Inserts the qualified lead into Notion database. Matrix (Send Message) – Notifies the sales team with lead context. Merge (Rejoin Streams) – Consolidates asynchronous branches before completion. Sticky Note – Documentation & config hints embedded directly in the canvas. Data Flow: Schedule/Webhook → SplitInBatches → HTTP Request (Enrichment) → Set → Code (Score) → If (Qualified?) → a. (Yes) Notion → Matrix b. (No) Wait (Cooldown) → Merge Customization Examples 1. Change Scoring Weights // Code node snippet const weights = { employeeCount: 0.4, // increase influence of company size emailDeliverability: 0.2, industryMatch: 0.25, techStack: 0.15, }; 2. Notify Different Matrix Rooms Based on Territory // If node expression {{ $json.country === 'US' ? '!usSales:matrix.org' : '!intlSales:matrix.org' }} Data Output Format The workflow outputs structured JSON data: { "name": "Jane Doe", "email": "[email protected]", "company": "Acme Co.", "enrichment": { "employeeCount": 120, "industry": "SaaS", "techStack": ["AWS", "React"] }, "score": 83, "qualified": true, "notionPageId": "9b2a4c09-0bf4-4b58-988a-1f361b0a2c20", "matrixEventId": "$15163622445EBvZJ:matrix.org" } Troubleshooting Common Issues Low or zero scores for valid leads – Review weighting logic and API response mapping in the Code node. Notion “Missing required property” error – Ensure all mandatory database fields are mapped and Notion token has write access. Matrix authentication failure – Double-check username/password or switch to an access token login method. Performance Tips Reduce SPLIT_IN_BATCHES size if you’re hitting API rate limits. Enable “Execute Once” during testing to prevent excess API usage. Pro Tips: Store enrichment API keys as n8n credentials, not hard-coded strings. Add a second If node to flag “Priority” leads (score > 90) for immediate follow-up. Use n8n’s built-in logging to create an audit trail by writing each execution to a Loggly/Datadog endpoint. This is a community template provided “as is.” Always test thoroughly in a non-production environment before activating in production.

Popular ways to use the Matrix and Notion integration

Build your own Matrix and Notion integration

Create custom Matrix and Notion workflows by choosing triggers and actions. Nodes come with global operations and settings, as well as app-specific parameters that can be configured. You can also use the HTTP Request node to query data from any app or service with a REST API.

Matrix supported actions

Notion supported actions

Matrix and Notion integration details

Matrix

Matrix

Matrix is an open-source network that facilitates secure, real-time and decentralized communication. It offers powerful solutions such as HTTP APIs and SDKs to create chat bots and other messaging tools, end-to-end encryption, VoIP and much more.

Notion

Notion

Notion is an all-in-one workspace for you and your team. It helps team members create tasks, wikis, and databases all at one place.

FAQ about Matrix integrations

Need help setting up your Matrix and Notion integration?

Discover our latest community's recommendations and join the discussions about Matrix and Notion integration.

  • Justin Cheu

    Notion Node Bug: The relation id "fffbfe90567a-8132-b56d-c3acc1e8eb71" is not a valid uuid with optional dashes

    Justin Cheu

    The relation id “fffbfe90567a-8132-b56d-c3acc1e8eb71” is not a valid uuid with optional dashes. { "errorMessage": "The relation id \"fffbfe90567a-8132-b56d-c3acc1e8eb71\" is not a valid uuid with optional dashes.", …

    Open topic
  • Cris A. Works

    Problem activating workflow. NodeAPIError

    Cris A. Works

    Describe the issue: Whenever I run this command: docker run -it --rm --name n8n -p 5678:5678 -v C:\Users\billy\.n8n:/home/node/.n8n docker.n8n.io/n8nio/n8n Yields in a looping error. It didn’t used to happen before. W…

    Open topic
  • Oliver Cordingley

    Notion append block formatting, using loop, still no luck

    Oliver Cordingley

    Hey, I’m using open AI to write written reports which have a set structure using H2 H3 and bullet points. The output should be delivered inside of a notion database page as an appended block. My output from open AI is ra…

    Open topic
  • Martin

    Any way to embed the interactive flow diagrams into notion?

    Martin

    Is there any way to replicate the way we share templates here on the forum within notion pages? (eg Creating an API endpoint | n8n workflow template) We use notion for documentation purposes and I’d love to be able to u…

    Open topic
  • Liam Skaff

    Notion Relations ID Error

    Liam Skaff

    Hello. Recently I’ve been getting this error in my Notion Node when trying to insert an ID in the relations tab. I contacted Notion support and they told me that the problem is from n8n. This is the error I’m receiving…

    Open topic

Looking to integrate Slack and VirusTotal in your company?

Three colleagues talking around laptops at a shared desk

Trusted by teams building smarter workflows.

Why

Why use n8n to integrate Matrix with Notion

Handle branching, merging and iteration easily. Pause your workflow to wait for external events.

Re-run single steps to test changes in no time. And pin your data to avoid generating trigger events every time you execute.

Your data is displayed alongside your settings, making edge cases easy to track down.

Use 1000+ workflow templates available from our core team and our community.

Copy and paste, easily import and export workflows.

Simple enough to 
understand + sophisticated 
enough to ship

Man in a brown jacket working at his desk by a window