---
title: "Een webhook maken"
description: "Laat een ander systeem namens een medewerker een formulier indienen: voeg een webhook toe aan het formulier, kies welk HRIS-id de medewerker identificeert, maak het secret eenmalig aan, en lees het log van wat er binnenkwam."
sidebar:
  order: 2
area: flows
feature: forms
appPath: /flows/home
lastVerified: 2026-11-15
version: "2026-10-30"
audience: admin
screenshots:
  - id: flows-forms-webhook-drawer
    caption: Het Settings-zijpaneel op een formulier, met de URL, header, subject en voorbeeldbody van de webhook.
related:
  - flows/forms/reference-webhook-api
  - flows/forms/build-a-form
  - notices
intercom:
  - id: "16858360"
    title: Create a Webhook (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16858360-create-a-webhook-pyn-2
    note: replaces
translation:
  source: flows/forms/create-a-webhook.mdx
  sourceSha: 88dd3263f023bcd0343ab040ded33eaba8203476
---

Sommige antwoorden bestaan al in een ander systeem: een afgeronde training in je LMS, een apparatuuraanvraag in een ticketingtool, een ondertekend document. Met een webhook op een formulier kan dat systeem het antwoord als inzending in Pyn posten, vastgelegd bij de medewerker die het noemt.

## Voordat je begint

- Je bent een Admin.
- Het formulier is gebouwd en gepubliceerd, met veldlabels waar je andere systeem op kan mappen. Zie [Een formulier bouwen](https://support.pyn.ai/nl/flows/forms/build-a-form/).
- Het andere systeem kan van elke medewerker het id uit je HRIS meesturen, hetzelfde id dat Pyn uit die integratie heeft.

![Het Settings-zijpaneel op een formulier, met de URL, header, subject en voorbeeldbody van de webhook.](https://support.pyn.ai/media/flows/forms/flows-forms-webhook-drawer.png)

## Stappen

1. Open in Pyn **Flows** in de linkernavigatie, selecteer **Forms** en dan het formulier.

2. Selecteer **Settings** in de balk rechts van de editor. Het zijpaneel toont **Add a webhook to let another system submit this form on an employee's behalf.** Selecteer **Add Webhook**. Kan de webhook niet worden toegevoegd, dan meldt een toast **Could not add this webhook** en blijft het zijpaneel zoals het was.

3. Bovenaan het zijpaneel toont de melding **This webhook accepts nothing until it has a secret.** Selecteer **Create Secret**; de melding toont dan **Copy this secret now. It is shown once and cannot be retrieved later.** Kopieer het naar het andere systeem en selecteer dan **Done**. Kan het secret niet worden aangemaakt, dan meldt een toast **Could not create the secret** en blijft de melding zoals ze was. Een webhook die al een secret heeft toont **This webhook already has a secret. Replace it if the old one has been lost.** en biedt in plaats daarvan **Replace Secret**; zie hieronder.

4. Kopieer onder de melding de **URL** en noteer de header: `Authorization: Bearer <secret>`.

5. Selecteer onder **Subject** het bronsysteem waarvan het andere systeem het id gaat meesturen, bijvoorbeeld **BambooHR Employee ID** of **Workday Worker ID**. De beschrijving toont **The submission is recorded against the employee holding this id.**

6. Lees het voorbeeld onder **Post a body of this shape.** Het noemt elk veld bij zijn alias (het label in camelCase) met een voorbeeldwaarde, plus `subject_id`.

7. Stuur een testpayload vanuit het andere systeem en lees het log onderaan het zijpaneel (**Payloads this webhook has taken, and what became of them.**). Een groene regel toont **Recorded a submission for the ... identifier ...**; een rode noemt het probleem.

> **Caution:** Een verloren secret kan niet worden hersteld. Selecteer **Replace Secret** om een nieuw aan te maken; het dialoogvenster **Replace Webhook Secret** waarschuwt **The current secret stops working immediately. Anything calling this webhook will need the new one.** en **Replace** bevestigt het. Kan het secret niet worden vervangen, dan meldt een toast **Could not replace the secret** en blijft het oude werken.

## Het secret roteren en het log lezen

- **Replace Secret** roteert het secret in één stap en het oude werkt meteen niet meer; werk het aanroepende systeem bij voordat je bevestigt.
- Het log toont de 20 meest recente regels. Zodra er een regel is, downloadt een exportpictogram ernaast het hele log als `pyn-webhook-log.csv` (`receivedAt`, `outcome`, `action`, `code`, `message`, `eventId`, `subjectId`, `submissionId`).
- Een afgewezen payload geeft ook een notice in [Notices](https://support.pyn.ai/nl/notices/), en dezelfde herhaalde fout houdt één notice actueel in plaats van vele; de rij biedt **Acknowledge** en dan **Archive**. De notificatie-instellingen van de workspace bepalen of elke admin wordt gemaild of alleen de owner.

## Wat je zou moeten zien

Geaccepteerde payloads verschijnen als inzendingen in het **Activity**-zijpaneel van het formulier, en het record van de medewerker bevat een eventuele Buddy- of Mentor-waarde. Per webhook kan voor elke medewerker één keer worden ingediend; een herhaling wordt gelogd als `already-submitted`. [Webhook-API](https://support.pyn.ai/nl/flows/forms/reference-webhook-api/) somt het endpoint, de headers, de body, de antwoorden en elke logcode op.

## Gerelateerd

- [Webhook-API](https://support.pyn.ai/nl/flows/forms/reference-webhook-api/) voor het exacte verzoek en de antwoorden.
- [Een formulier bouwen](https://support.pyn.ai/nl/flows/forms/build-a-form/) voor de velden die een payload vult.
- [Notices](https://support.pyn.ai/nl/notices/) voor waar fouten zichtbaar worden.
