---
title: "n8n"
description: "Automatisearje Quire mei n8n en de Quire-mienskipnode."
image: "https://docs.quirelms.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/fy/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
De Quire-mienskipnode foar n8n jout dy in aksjeknooppunt foar de REST API en in
triggerknooppunt dat in wurkstream begjint as der wat bart yn Quire. De node hat
gjin ôfhinklikheden by it draaien en foeget dus neat oars as himsels ta oan dyn n8n-ynstallaasje.
## Ynstallearje
Iepenje yn n8n **Ynstellingen**, dêrnei **Mienskipsknooppunten**, kies **Ynstallearje**
en fier `@quire/n8n-node` yn. By in selsbehearde n8n kinst ynstee
`npm install @quire/n8n-node` útfiere yn de brûkersmap fan n8n en opnij starte.
## Ferbine
Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.
Meitsje in bewiis oan. Der binne twa soarten:
- **Quire API Key**: **Basis-URL** is it adres fan dyn organisaasje sûnder
efterôfgeande slash, lykas `https://acme.quirelms.com`. **API-kaai** is in kaai dy't
in behearder oanmakke hat op `/admin/integrations/api-keys` en begjint mei
`qk_live_`. Jou him allinnich de scopes dy't de wurkstream nedich hat.
- **Quire OAuth2**: foar wurkstreamen dy't as in beskate persoan hannelje moatte.
Registrearje in OAuth-client op `/admin/integrations/oauth-clients` mei it
trochferwizingadres fan n8n (n8n lit dit by it bewiis sjen), en fier de client-ID,
it geheim en de scopes yn.
## Aksjes
De node **Quire** wurket mei brûkers, kursussen, ynskriuwingen, groepen, foltôging,
sifers, sertifikaten, ynstjoeringen, kwisbesykjen, programma's, oarders, e-mail en
organisaasjes. Foar elke boarne biedt er list, ophelje, oanmeitsje, bywurkje en wiskje
dêr't de API dat stipet, en ek bywurkje op eksterne ID; dat is geskikt foar in
syngronisaasje: itselde proses twa kear útfiere makket neat dûbel.
De operaasjes wurde oanmakke út it OpenAPI-dokumint fan Quire, dus se komme fjild foar
fjild oerien mei de [API-referinsje](https://docs.quirelms.com/api/). Elke operaasje kin ek as ark troch in
n8n AI-agent brûkt wurde; de beskriuwing komt út de API-referinsje.
Standert jouwe listen alle siden werom. Skeakelje **Alles weromjaan** út en set in limyt
yn foar grutte organisaasjes.
## Trigger
Foegje it knooppunt **Quire Trigger** ta, kies it bewiis en selektearje de **Barrens**:
ien barren op namme lykas `enrolment.created`, in hiel gebiet lykas `course.*` of alles.
As de wurkstream aktivearre wurdt, makket de node yn Quire in webhook-abonnemint foar it
adres fan n8n; as de wurkstream deaktivearre wurdt, wurdt dat abonnemint fuorthelle.
De hantekening fan elke levering wurdt kontrolearre foardat de wurkstream begjint.
In levering dy't net ferifiearre wurdt, wurdt wegere mei in nodeflater, sadat in ferfalske
fersyk dyn wurkstream net starte kin. De `data` fan it barren befettet identifiers;
foegje nei de trigger in Quire-node ta om it folsleine record op te heljen.
## Foarbyld: wolkomstmail by ynskriuwing
1. **Quire Trigger** op `enrolment.created`.
2. **Quire**-node, boarne **Brûkers**, operaasje **Ophelje**, mei de brûker-ID
`{{$json.data.user_id}}`.
3. **Quire**-node, boarne **Kursussen**, operaasje **Ophelje**, mei
`{{$json.data.course_id}}`.
4. Dyn e-mail- of petearknooppunt, mei de namme fan de persoan en de kursustitel.
## Problemen oplosse
- **401** by elke oprop: de basis-URL en kaai hearre by ferskillende organisaasjes, of de kaai is ynlutsen.
- **403** by ien operaasje: de kaai hat dy scope net. Foegje him ta op `/admin/integrations/api-keys`.
- De trigger giet nea ôf: it webhook-adres fan n8n moat foar Quire fia HTTPS te berikken wêze.
Kontrolearje it leveringslogboek fan it abonnemint op `/admin/webhooks`.
Source: https://docs.quirelms.com/fy/integrations/n8n/index.mdx
