---
title: "n8n"
description: "Automatiséiert Quire mat n8n an dem Quire Community-Node."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/lb/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

<span id="n8n"></span>

De Quire Community-Node fir n8n gëtt Iech en Aktiouns-Node fir d'REST API an en Trigger-Node, deen en Workflow start, wann an Quire eppes geschéit. En huet keng Laufzäit-Ofhängegkeeten, en füügt also zu Ärer n8n-Instanz näischt derbäi ausser sech selwer.

## Installéieren <!--quire:install-->

Öffnen an n8n **Settings**, dann **Community nodes**, wielt **Install** a gitt `@quire/n8n-node` an. Op engem selwer gehostete n8n kënnt Dir amplaz `npm install @quire/n8n-node` am n8n-Benotzer-Ordner ausféieren an nei starten.

## Verbannen <!--quire:connect-->

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-api-keys.webp" alt="The API keys page with a key named for an n8n automation." width="944" height="700" loading="lazy" decoding="async"><figcaption>Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.</figcaption></figure>

Erstellt Zougangsdaten. Zwei Aarten ginn ugebueden:

- **Quire API Key**: **Base URL** ass d'Adress vun Ärer Organisatioun ouni
  Slash um Enn, wéi `https://acme.quirelms.com`. **API Key** ass e Schlëssel, deen
  en Administrator um `/admin/integrations/api-keys` gemaach huet, deen mat
  `qk_live_` ufänkt. Gitt him nëmmen d'Scopes, déi den Workflow brauch.
- **Quire OAuth2**: fir Workflows, déi wéi eng bestëmmte Persoun handelen.
  Registréiert e Client um `/admin/integrations/oauth-clients` mat n8n sengem
  Redirect-Adress (n8n weist en op de Zougangsdaten), an erfuert dunn d'Client-ID,
  d'Geheimnis a d'Scopes.

## Aktiounen <!--quire:actions-->

De **Quire**-Node deckt Benotzer, Coursen, Aschreiwungen, Gruppen, Ofschléisser, Noten, Zertifikater, Abgaben, Quiz-Versich, Programmer, Uerder, E-Mail an Organisatiounen. All bitt Lëschten, kréien, erstellen, aktualiséieren an läschen, wou d'API et mécht, an upsert no externem ID — wat Dir fir e Sync wëllt: féiert gläich zweemol de selwechte Workflow aus a näischt gëtt duplizéiert.

D'Operatioune ginn aus Quire sengem OpenAPI-Dokument generéiert, sou datt se der [API-Referenz](https://docs.quirelms.com/api/) Feld fir Feld entspriechen. All Operatioun kann och als Tool vun engem n8n-KI-Agent benotzt ginn; seng Beschreiwung kënnt aus der API-Referenz.

Lëschten iwwerdroen all Säit standardméisseg. Maacht **Return All** aus a setzt en Limit fir grouss Organisatiounen.

## Trigger <!--quire:trigger-->

Füügt de **Quire Trigger**-Node derbäi, wielt d'Zougangsdaten an wielt d'**Evenementer**: en Evenement no Numm wéi `enrolment.created`, e ganze Beräich wéi `course.*`, oder alles. Wann Dir den Workflow aktivéiert, erstellt de Node en Webhook-Abonnement an Quire fir n8n seng Adress; wann Dir en desaktivéiert, gëtt d'Abonnement geholl.

D'Signatur vun all Liwwerung gëtt iwwerpréift, ier de Workflow leeft. Eng Liwwerung, déi net iwwerpréift gëtt, gëtt mat engem Node-Feeler weiggeworfen, sou datt eng fälschteg Demande Ären Workflow net starten kann. D'`data` vum Evenement dréit Identifikatioren; füügt no dem Trigger e Quire-Node derbäi, fir de ganzen Dossier ze fannen.

## Beispill: Wëllkommens-E-Mail bei der Aschreiwung <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** op `enrolment.created`.
2. **Quire**-Node, Ressource **Users**, Operatioun **Get**, mat der Benotzer-ID
   `{{$json.data.user_id}}`.
3. **Quire**-Node, Ressource **Courses**, Operatioun **Get**, mat
   `{{$json.data.course_id}}`.
4. Ären E-Mail- oder Chat-Node, mat dem Numm vun der Persoun an dem Titel vum Cours.

## Problemléisung <!--quire:troubleshooting-->

- **401** bei all Uruff: d'Base URL an de Schlëssel gehéieren verschiddenen
  Organisatiounen, oder de Schlëssel gouf annuléiert.
- **403** bei enger Operatioun: de Schlëssel feelt dee Scope. Füügt en ëm
  `/admin/integrations/api-keys` derbäi.
- Den Trigger fält ni un: d'Webhook-Adress vun n8n muss vun Quire iwwer HTTPS
  erreechbar sinn. Kuckt de Liwwerungs-Log vum Abonnement ëm
  `/admin/webhooks`.

Source: https://docs.quirelms.com/lb/integrations/n8n/index.mdx
