Met de FITsociety-koppeling voor n8n bouw je workflows tussen FITsociety en andere diensten. De koppeling bestaat uit FITsociety voor acties en FITsociety Trigger voor gebeurtenissen die een workflow starten.
Beschikbaarheid: deze handleiding is voor een zelf gehoste n8n-omgeving. Het pakket is gepubliceerd op npm; goedkeuring voor n8n Cloud is nog niet verleend. Je kunt het daarom nog niet als goedgekeurde communitynode in n8n Cloud installeren.
Wat heb je nodig?
Een zelf gehoste n8n-omgeving, versie 2.44.6 of nieuwer. Dit is de minimaal ondersteunde en geteste versie.
Een n8n Owner of Admin die communitynodes mag installeren.
Bedrijfsspecifieke n8n-toegang, verstrekt door FITsociety na goedkeuring door de bedrijfsbeheerder.
Voor directe triggers: een publiek bereikbare HTTPS-webhook-URL van je n8n-omgeving.
Vraag de n8n-toegang bij FITsociety-support aan en beschrijf welke gegevens je wilt lezen en welke handelingen je wilt automatiseren. De toegang wordt op die behoefte afgestemd. Een kaart in het koppelingenoverzicht maakt deze gegevens nog niet automatisch aan. Inloggegevens voor Zapier, Make of een andere koppeling werken hier niet.
Stap 1: installeer het pakket
Open in n8n Settings → Community nodes.
Kies Install.
Vul de pakketnaam
n8n-nodes-fitsocietyin.Lees en bevestig de melding over communitynodes en klik op Install.
Controleer dat het pakket geïnstalleerd is. De versie waarop deze handleiding is gebaseerd is 0.1.2.
Gebruik het FITsociety-pakket op npm. De beheerder vindt aanvullende installatie-informatie in de n8n-documentatie. Bij een omgeving met meerdere workers moet het pakket op alle workers beschikbaar zijn.
Stap 2: maak de verbinding
Maak een workflow en voeg de node FITsociety toe.
Maak bij Credentials een nieuwe verbinding van het type FITsociety OAuth2 API.
Vul bij API Base URL de door FITsociety verstrekte URL in. Voor productie is dat
https://api.fitsociety.io/public/v1.Vul de bij elkaar horende Company ID, Client ID en Client Secret in.
Sla de credential op en controleer dat de verbindingstest slaagt.
De verbindingstest leest alleen het bedrijfsprofiel en wijzigt geen gegevens. Er is geen aparte OAuth-terugkeer-URL nodig. n8n bewaart de inloggegevens versleuteld. Bewaar de Client Secret uitsluitend als credential en niet als tekst in een workflow, screenshot of helpdeskbericht.
Stap 3: voer een veilige eerste test uit
Verbind een Manual Trigger met de FITsociety-node. Kies Resource: Client en Operation: Search. Gebruik onder Filters het exacte e-mailadres van een testcliënt en voer de stap uit. Controleer of de verwachte cliënt uit het juiste bedrijf terugkomt. Kies daarna pas een actie die gegevens wijzigt.
Meerdere bedrijven of toegang beëindigen
Maak voor elk bedrijf een eigen credential met de daarvoor verstrekte gegevens. Om een workflow te stoppen schakel je hem uit. Wil je ook de bedrijfstoegang volledig intrekken, vraag dan de bedrijfsbeheerder of FITsociety-support om het betreffende n8n-toegangspaar in te trekken. Alleen het stoppen van één workflow trekt de credential niet in.