---
title: "Zapier"
description: "Verbinden Sie Quire mit Zapier über Webhooks und die REST-API."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier verbindet sich über dieselbe REST-API, OAuth-Clients und Webhooks mit Quire, die jede Integration verwendet. Auf keiner Seite gibt es Quire-spezifischen Code. Daher kann ein Zap alles ausführen, was die [API-Referenz](https://docs.quirelms.com/api/) anbietet.

## Einen Zap starten, wenn in Quire etwas geschieht <!--quire:start-a-zap-when-something-happens-in-quire-->

1. Wählen Sie in Zapier **Webhooks by Zapier** als Trigger und das Ereignis **Catch Raw Hook**. Raw, weil die Signatur über genau die Bytes berechnet wird, die Quire gesendet hat. Kopieren Sie die von Zapier angegebene Adresse.
2. Öffnen Sie in Quire `/admin/webhooks`, wählen Sie **Add subscription**, fügen Sie die Adresse ein und wählen Sie die Ereignisse, zum Beispiel `course_completion.changed`. Quire sendet zuerst ein Testereignis; das Abonnement beginnt, sobald Zapier es empfangen hat.
3. Fügen Sie einen Schritt **Code by Zapier** hinzu, der die Signatur anhand des Abonnement-Secrets prüft, wie im [Entwicklerhandbuch](/de/developer/#webhooks) beschrieben. Beenden Sie den Zap, wenn die Prüfung fehlschlägt.
4. Parsen Sie den Body und fahren Sie mit den benötigten Schritten fort.

## Von einem Zap aus in Quire handeln <!--quire:act-in-quire-from-a-zap-->

Verwenden Sie **Webhooks by Zapier** mit der Aktion **Custom Request** oder in einem App-Schritt **API Request**:

- **URL**: `https://acme.quirelms.com/api/v1/...`, zum Beispiel `/api/v1/enrolments`, um jemanden einzuschreiben.
- **Headers**: `Authorization: Bearer qk_live_...` mit einem Schlüssel, der ausschließlich für diesen Zap unter `/admin/integrations/api-keys` erstellt wurde, und ein `Idempotency-Key`, der aus der ID des Triggers gebildet wird. So wird dieselbe Person nicht zweimal eingeschrieben, wenn Zapier den Zap erneut ausführt.
- **Data**: JSON, wie in der API-Referenz beschrieben.

Wenn Sie als Person statt als Organisation handeln möchten, registrieren Sie unter `/admin/integrations/oauth-clients` einen OAuth-Client mit der Weiterleitungsadresse von Zapier und verwenden ihn in einer privaten Zapier-Integration.

## Beispiel: Einen Kunden nach Abschluss eines Deals einschreiben <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Trigger: „Deal gewonnen“ in Ihrem CRM.
2. Custom Request `PUT /api/v1/users/ext:{customer id}` mit Name und E-Mail-Adresse der Person: Erstellt den Benutzer oder aktualisiert ihn, falls er bereits existiert.
3. Custom Request `POST /api/v1/enrolments` mit Benutzer und Kurs sowie `Idempotency-Key: deal-{deal id}`.

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