---
title: "Zapier"
description: "Koppel Quire aan Zapier met webhooks en die REST API."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier koppel aan Quire deur dieselfde REST API, OAuth-kliënte en webhooks wat elke integrasie gebruik. Daar is geen Quire-spesifieke kode aan weerskante nie, dus kan ’n Zap alles doen wat die [API-verwysing](https://docs.quirelms.com/api/) bied.

## Begin ’n Zap wanneer iets in Quire gebeur <!--quire:start-a-zap-when-something-happens-in-quire-->

1. Kies in Zapier **Webhooks by Zapier** as sneller, met die gebeurtenis **Catch Raw Hook**. Rou data, omdat die handtekening bereken word oor die presiese grepe wat Quire gestuur het. Kopieer die adres wat Zapier gee.
2. Maak in Quire `/admin/webhooks` oop, kies **Add subscription**, plak die adres en kies gebeurtenisse, byvoorbeeld `course_completion.changed`. Quire stuur eers ’n toetsgebeurtenis; die intekening begin sodra Zapier dit ontvang het.
3. Voeg ’n **Code by Zapier**-stap by wat die handtekening met die intekeninggeheim nagaan, soos in die [ontwikkelaarsgids](/af/developer/#webhooks) gewys. Stop die Zap as dit nie bekragtig nie.
4. Ontleed die inhoud en gaan voort met die stappe wat jy nodig het.

## Tree vanuit ’n Zap in Quire op <!--quire:act-in-quire-from-a-zap-->

Gebruik **Webhooks by Zapier** met die **Custom Request**-aksie, of **API Request** in ’n toepassingstap:

- **URL**: `https://acme.quirelms.com/api/v1/...`, byvoorbeeld `/api/v1/enrolments` om iemand in te skryf.
- **Headers**: `Authorization: Bearer qk_live_...` met ’n sleutel wat net vir hierdie Zap by `/admin/integrations/api-keys` gemaak is, en ’n `Idempotency-Key` wat uit die sneller se ID gebou is, sodat ’n herhaling deur Zapier nie dieselfde persoon twee keer inskryf nie.
- **Data**: JSON, soos die API-verwysing beskryf.

Om as ’n persoon eerder as die organisasie op te tree, registreer ’n OAuth-kliënt by `/admin/integrations/oauth-clients` met Zapier se herleidingsadres en gebruik dit vanuit ’n private Zapier-integrasie.

## Voorbeeld: skryf ’n kliënt in wanneer ’n transaksie sluit <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Sneller: jou CRM se “transaksie gewen”.
2. Pasgemaakte versoek `PUT /api/v1/users/ext:{customer id}` met die persoon se naam en e-pos: skep die gebruiker of werk hulle by as hulle reeds bestaan.
3. Pasgemaakte versoek `POST /api/v1/enrolments` met die gebruiker en kursus, en `Idempotency-Key: deal-{deal id}`.

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