n8n-handleiding (2026): bouw je eerste workflow stap voor stap
komasu Tools wordt gesteund door lezers zoals jij. Als je via onze links koopt, ontvangen we mogelijk een affiliatecommissie, waardoor we ons onderzoek gratis kunnen aanbieden. Hoe wij geld verdienen
Een gepubliceerde n8n Cloud-workflow die volgens schema draait, gegevens uit een API ophaalt, alleen de items bewaart waar je om geeft en die in een Slack-kanaal plaatst.
Probeer n8n gratisWat je gaat bouwen
In deze handleiding bouw je op n8n Cloud een kleine maar realistische automatisering. Elke ochtend haalt hij een lijst met records uit een API, bewaart alleen de records die aan een voorwaarde voldoen en plaatst elke overeenkomst in een Slack-kanaal. Denk aan nieuwe bestellingen boven een bepaalde waarde, openstaande supporttickets of taken die vandaag moeten.
De workflow gebruikt vier nodes, allemaal uit de officiële documentatie van n8n:
- Schedule Trigger start de workflow op een vaste tijd.
- HTTP Request roept de API aan en geeft de gegevens terug.
- Filter bewaart alleen de items die aan je voorwaarde voldoen.
- Slack stuurt een bericht voor elk overgebleven item.
Onderweg leer je de kernideeën van n8n: een workflow is de hele automatisering, een node is één stap en gegevens bewegen tussen nodes als een lijst van items. Een execution is één run van de hele workflow, en zo telt n8n Cloud ook het gebruik.
Voordat je begint
Je hebt drie dingen nodig:
- Een n8n Cloud-account. Volgens n8n vereist de proefperiode van 14 dagen geen creditcard en bevat ze Pro-functies met 1.000 executions. Dat is veel meer dan deze handleiding gebruikt. Start een gratis n8n Cloud-proefperiode.
- Een API die JSON teruggeeft. Dat kan je webwinkel, helpdesk of projecttool zijn, of een openbare API. Je hebt de URL nodig en, als die er een vereist, een API-sleutel. Bekijk het antwoord één keer in je browser of in de documentatie van de API, zodat je de veldnamen kent.
- Een Slack-workspace waar je apps mag toevoegen, en een kanaal voor de testberichten.
Geef je de voorkeur aan e-mail, dan kun je Slack in stap 5 vervangen door de Gmail-node. De rest blijft hetzelfde.
Twijfel je nog of n8n de juiste tool is, lees dan eerst onze n8n-review.
Stap 1: maak een nieuwe workflow
Log in bij n8n Cloud. Selecteer in het linkermenu Personal en daarna Create workflow. Je ziet nu een leeg canvas, het gebied waar je nodes plaatst en verbindt.
Geef de workflow een duidelijke naam, zoals "Daily filtered report to Slack". Namen doen ertoe zodra je tientallen workflows hebt, en ze verschijnen in foutmeldingen.
n8n biedt ook een ingebouwde Assistant die een workflow kan bouwen vanuit een chatprompt. Die is later nuttig, maar de eerste keer met de hand bouwen leert je hoe de onderdelen in elkaar passen.
Stap 2: voeg een Schedule Trigger toe
Elke workflow begint met een triggernode. Selecteer Add first step en kies daarna On a schedule. Dit voegt de node Schedule Trigger toe.
Laat in de node-instellingen het interval op dagen staan en stel Trigger at Hour in op de tijd die je wilt, bijvoorbeeld 8 uur 's ochtends. Het schema gebruikt de tijdzone van je n8n-instance, dus controleer of die overeenkomt met waar jij bent.
Hernoem de node naar iets beschrijvends, zoals "Every day at 8 AM". Sluit het paneel om terug te keren naar het canvas.
Stap 3: haal gegevens op met de HTTP Request-node
Selecteer de knop + aan de rechterkant van de triggernode. Typ in Search nodes "http" en kies HTTP Request.
Stel de methode in op GET en plak het adres van je API in het veld URL. Heeft de API authenticatie nodig, kies die dan onder de authenticatie-instellingen en bewaar de sleutel als credential. Credentials worden apart van de workflow opgeslagen, dus de sleutel verschijnt niet in de node zelf en kan worden hergebruikt.
Selecteer nu Execute step. n8n roept de API één keer aan en toont het resultaat in het uitvoerpaneel. Is het antwoord een lijst, dan zie je meerdere items. Staat je lijst genest in een veld van één object (bijvoorbeeld data of results), voeg dan hierna een Split Out-node toe en wijs die naar dat veld, zodat elk record een eigen item wordt.
Hernoem de node naar iets als "Get records". Een stap uitvoeren en de echte uitvoer bekijken voordat je verdergaat is de nuttigste gewoonte in n8n.
Stap 4: bewaar alleen wat telt met de Filter-node
Voeg na HTTP Request een node toe en zoek naar Filter. Volgens de documentatie van n8n geeft de Filter-node items door die aan een voorwaarde voldoen en laat hij de rest vallen.
Stel de voorwaarde in:
- Verwijs in het eerste waardeveld naar een veld uit de invoer. Open het invoerpaneel links en sleep het veld (bijvoorbeeld
statusofamount) in het waardevak. n8n schrijft een expressie zoals{{ $json.status }}, die het tijdens het uitvoeren vervangt door de echte waarde van elk item. - Kies in de keuzelijst voor het gegevenstype het type en de vergelijking, zoals String met "is equal to", of Number met "is greater than".
- Typ de waarde waarmee je vergelijkt, zoals
openof100.
Om meer regels toe te voegen selecteer je Add condition en kies je AND (alle voorwaarden moeten kloppen) of OR (elke voorwaarde mag kloppen). Je kunt AND en OR niet mengen binnen één Filter-node. Onder opties maakt Ignore Case tekstvergelijkingen hoofdletterongevoelig, en Less Strict Type Validation helpt als je een foutmelding "wrong type" ziet.
Selecteer opnieuw Execute step. De uitvoer zou nu alleen de overeenkomende items moeten bevatten. Is die leeg, controleer dan je voorwaarde aan de hand van de invoergegevens voordat je verdergaat.
Stap 5: plaats elke overeenkomst in Slack
Voeg na Filter een node toe en zoek naar Slack. Kies als actie de resource Message met de bewerking Send, die een bericht in een kanaal plaatst.
Koppel daarna je Slack-account. De Slack-node ondersteunt OAuth2- en Access Token-authenticatie. Maak vanuit de node een nieuwe credential aan en volg de stappen op de pagina met Slack-credentials van n8n. Zet je je eigen Slack-app op, zorg dan dat die de scopes heeft die de documentatie noemt voor het versturen van berichten.
Kies daarna het kanaal en schrijf de berichttekst. Meng vaste tekst met expressies uit de invoer, bijvoorbeeld:
New item: {{ $json.name }} (status: {{ $json.status }})
Gebruik de veldnamen uit je eigen gegevens. n8n voert de Slack-node één keer per binnenkomend item uit, dus drie gefilterde items leveren drie berichten op.
Selecteer Execute step en controleer het Slack-kanaal. Zien de testberichten er goed uit, hernoem de node dan naar "Post to Slack".
Stap 6: test de hele workflow en publiceer hem
Tot nu toe heb je één node tegelijk getest. Selecteer nu Execute onder het canvas om de hele workflow vanaf de trigger te draaien. Elke node zou een groen vinkje moeten tonen als hij slaagt.
Een geteste workflow draait nog niet vanzelf. Om het schema aan te zetten selecteer je Publish in de kop van het canvas. Vanaf nu start n8n de workflow automatisch op de tijd die je in stap 2 hebt ingesteld, en telt elke run als één execution.
Pas je de workflow later aan, vergeet dan niet opnieuw te publiceren, zodat de live versie je wijzigingen oppikt.
Stap 7: controleer runs en voeg een foutmelding toe
Open het tabblad executions van de workflow om eerdere runs te zien, of elke run is geslaagd en welke gegevens door elke node gingen. Hier kijk je eerst als er iets misgaat.
Maak voor een vangnet een tweede workflow die begint met de Error Trigger-node en een Slack-bericht of e-mail met de foutdetails stuurt. Open daarna je hoofdworkflow, ga naar Options > Settings en kies die workflow onder Error workflow. Volgens de documentatie van n8n ontvangt de error workflow het ID van de mislukte execution, de foutmelding en de laatste node die is uitgevoerd, en kan één error workflow veel workflows bedienen.
Stap 8 (optioneel): draai n8n zelf met Docker
n8n Cloud is de makkelijkste manier om te beginnen, maar je kunt ook de gratis Community Edition zelf hosten. De licentie is de Sustainable Use License, die intern zakelijk, persoonlijk en niet-commercieel gebruik toestaat. De documentatie van n8n waarschuwt dat zelf hosten technische kennis vereist en dat fouten kunnen leiden tot gegevensverlies, beveiligingsproblemen en downtime.
Voor een lokale test beschrijft de documentatie deze opzet met Docker Desktop geïnstalleerd:
- Maak een volume aan zodat je gegevens herstarts overleven:
docker volume create n8n_data - Start n8n met de officiële image, met poort 5678 gemapt en het volume gekoppeld:
docker run -it --rm --name n8n -p 5678:5678 -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" -e TZ="<YOUR_TIMEZONE>" -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true -v n8n_data:/home/node/.n8n n8nio/n8n - Open
http://localhost:5678in je browser.
Vervang <YOUR_TIMEZONE> door een tijdzonenaam zoals America/New_York. Voor alles boven een lokale test raadt de documentatie van n8n de installatie met Docker Compose aan, en ben je zelf verantwoordelijk voor updates, back-ups en HTTPS. Sommige teamfuncties, zoals projecten en SSO, maken geen deel uit van de Community Edition.
Veelgemaakte fouten
- Testen maar nooit publiceren. Execute draait de workflow maar één keer. Totdat je Publish selecteert, wordt de Schedule Trigger niet afgevuurd.
- Items negeren. n8n verwerkt elk item dat een node bereikt. Geeft de API 50 records terug en is je filter fout, dan ontvangt Slack 50 berichten.
- Verwijzen naar velden die niet bestaan. Een expressie als
{{ $json.amount }}geeft niets terug als het veldtotalheet. Sleep velden altijd uit het invoerpaneel in plaats van ze te typen. - Geneste lijsten. Komen alle records als één item binnen, dan staat de lijst genest in een veld. Voeg vóór het Filter een Split Out-node toe.
- Verkeerde tijdzone. Een schema dat op het "verkeerde" uur afgaat, betekent meestal dat de tijdzone van de instance afwijkt van die van jou.
- API-sleutels hardcoderen. Bewaar sleutels als credentials, niet in URL's of berichttekst.
Volgende stappen
Je hebt nu een gepubliceerde workflow die elke ochtend draait en alleen meldt wat telt. Probeer vanaf hier een If-node toe te voegen om verschillende berichten voor verschillende gevallen te sturen, of vervang Slack door Gmail voor een e-mailoverzicht. De sjabloonbibliotheek van n8n is ook een goede plek om te zien hoe anderen vergelijkbare flows opzetten.
Wil je n8n met andere tools vergelijken voordat je meer bouwt, lees dan Make vs n8n en Zapier vs n8n, of volg onze Make-handleiding om daar dezelfde soort workflow te bouwen.
Veelgestelde vragen
Moet ik kunnen programmeren om deze handleiding te volgen?
Nee. Elke stap gebruikt de visuele nodes en formuliervelden van n8n. Je typt een paar korte expressies, maar geen code.
Kost de Cloud-proefperiode van n8n iets?
Volgens n8n vereist de Cloud-proefperiode van 14 dagen geen creditcard en bevat ze Pro-functies met 1.000 executions. Als je niet upgradet, eindigt de proefperiode automatisch.
Hoeveel executions gebruikt deze workflow?
Eén per run. n8n telt een execution als één run van de hele workflow, ongeacht hoeveel nodes die heeft, dus een schema van één keer per dag gebruikt ongeveer 30 executions per maand.
Wat is het verschil tussen Execute en Publish?
Execute draait de workflow één keer zodat je hem kunt testen. Publish maakt hem live, zodat de Schedule Trigger hem automatisch start op de tijden die je instelt.
Kan ik een e-mail sturen in plaats van een Slack-bericht?
Ja. Vervang de Slack-node door de Gmail-node of een andere e-mailnode en map dezelfde velden in het bericht.
Kan ik deze workflow op mijn eigen server draaien?
Ja. Je kunt de Community Edition van n8n met Docker zelf hosten, zoals beschreven in de laatste stap, en de workflow daar importeren of opnieuw bouwen.
Bekijk de updategeschiedenis van dit artikel
- Eerste publicatie.