---
title: "Zapier"
description: "Verbënnt Quire mat Zapier iwwer Webhooks an d'REST API."
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.

# Zapier

<span id="zapier"></span>

Zapier verbënnt sech mat Quire iwwer déiselwecht REST API, OAuth-Client a Webhooks, déi all Integratioun benotzt. Et gëtt kee spezielle Quire-Code op enger vun de Säiten, sou datt eng Zap alles maache kann, wat d'[API-Referenz](https://docs.quirelms.com/api/) bitt.

## Eng Zap starten, wann an Quire eppes geschéit <!--quire:start-a-zap-when-something-happens-in-quire-->

1. Wielt an Zapier **Webhooks by Zapier** als Trigger, mam Evenement
   **Catch Raw Hook**. Raw, well d'Signatur iwwer genau déi Bytes berechent
   gëtt, déi Quire geschéckt huet. Kopéiert d'Adress, déi Iech Zapier gëtt.
2. Öffnen an Quire `/admin/webhooks`, wielt **Abonnement derbäimaachen**, füügt
   d'Adress an a wielt d'Evenementer, z. B. `course_completion.changed`. Quire
   schéckt éischte en Test-Evenement; d'Abonnement start, sobold Zapier en
   kritt huet.
3. Füügt en **Code by Zapier**-Schritt derbäi, deen d'Signatur mam
   Abonnement-Geheimnis iwwerpréift, wéi am
   [Entwéckler-Guide](/lb/developer/#webhooks) geweist. Stoppt d'Zap, wann se
   net iwwerpréift.
4. Parst de Body a gitt mat de Schrëtt weider, déi Dir braucht.

## Aus enger Zap eraus an Quire handelen <!--quire:act-in-quire-from-a-zap-->

Benotzt **Webhooks by Zapier** mat der **Custom Request**-Aktion, oder **API Request** an engem App-Schritt:

- **URL**: `https://acme.quirelms.com/api/v1/...`, z. B.
  `/api/v1/enrolments` fir een anzeschreiwen.
- **Header**: `Authorization: Bearer qk_live_...` mat engem Schlëssel, deen
  ëm `/admin/integrations/api-keys` just fir dëse Zap gemaach gëtt, an engem
  `Idempotency-Key`, deen aus dem ID vum Trigger gebaut gëtt, sou datt eng Zap,
  déi Zapier erëmspillt, net déiselwecht Persoun zweemol inschreift.
- **Donnéeen**: JSON, wéi d'API-Referenz et beschreift.

Fir wéi eng Persoun an net wéi d'Organisatioun ze handelen, registréiert e Client ëm `/admin/integrations/oauth-clients` mat Zapier sengem Redirect-Adress a benotzt en aus enger privater Zapier-Integratioun.

## Beispill: e Client aschreiwen, wann en Deal ofgeschloss gëtt <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Trigger: Är CRM seng "deal won".
2. Custom request `PUT /api/v1/users/ext:{customer id}` mat dem Numm an der
   E-Mail vun der Persoun: erstellt de Benotzer, oder aktualiséiert en, wann
   en scho existéiert.
3. Custom request `POST /api/v1/enrolments` mat dem Benotzer an dem Cours, an
   `Idempotency-Key: deal-{deal id}`.

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