---
title: "Zapier"
description: "Ferbine Quire mei Zapier fia webhooks en de REST API."
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.

# Zapier

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

Zapier ferbynt mei Quire fia deselde REST API, OAuth-clients en webhooks as elke oare
yntegraasje. Oan gjin fan beide kanten is Quire-spesifike koade nedich; dus alles wat de
[API-referinsje](https://docs.quirelms.com/api/) biedt, kin in Zap dwaan.

## Begjin in Zap as der wat bart yn Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. Kies yn Zapier **Webhooks by Zapier** as trigger, mei it barren **Catch Raw Hook**.
   Raw, om't de hantekening berekkene wurdt oer de eksakte bytes dy't Quire stjoerd hat.
   Kopiearje it adres dat Zapier jout.
2. Iepenje yn Quire `/admin/webhooks`, kies **Abonnemint tafoegje**, plak it adres en
   selektearje de barrens, bygelyks `course_completion.changed`. Quire stjoert earst in
   testbarren; it abonnemint begjint as Zapier dat ûntfongen hat.
3. Foegje in stap **Code by Zapier** ta dy't de hantekening mei it geheim fan it abonnemint
   ferifiearret, sa't de [hantlieding foar ûntwikkelders](/fy/developer/#webhooks) sjen lit.
   Stopje de Zap as de hantekening net kloppet.
4. Parse de ynhâld en gean fierder mei de stappen dy'tst nedich hast.

## Hannelje yn Quire út in Zap wei <!--quire:act-in-quire-from-a-zap-->

Brûk **Webhooks by Zapier** mei de aksje **Custom Request**, of **API Request** yn in
appstap:

- **URL**: `https://acme.quirelms.com/api/v1/...`, bygelyks `/api/v1/enrolments` om immen yn te skriuwen.
- **Headers**: `Authorization: Bearer qk_live_...` mei in kaai dy'tst allinnich foar dizze
  Zap op `/admin/integrations/api-keys` makke hast, en in `Idempotency-Key` op basis fan
  it ID fan de trigger, sadat in troch Zapier opnij útfierde Zap deselde persoan net twa
  kear ynskriuwt.
- **Data**: JSON, sa't yn de API-referinsje beskreaun wurdt.

Om as persoan te hanneljen ynstee fan as organisaasje, registrearje in OAuth-client op
`/admin/integrations/oauth-clients` mei it trochferwizingadres fan Zapier en brûk dy yn
in privee Zapier-yntegraasje.

## Foarbyld: klant ynskriuwe as in deal sletten wurdt <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Trigger: it barren "deal won" fan dyn CRM.
2. Oanpast fersyk `PUT /api/v1/users/ext:{customer id}` mei namme en e-mail fan de persoan:
   makket de brûker oan of bywurket dy as er al bestiet.
3. Oanpast fersyk `POST /api/v1/enrolments` mei brûker en kursus,
   en `Idempotency-Key: deal-{deal id}`.

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