---
title: "Webhooks"
description: "Met inkomende webhooks kan een ander systeem een formulier namens een medewerker indienen. De weergave Webhooks toont elke webhook met zijn endpoint; open er een voor de status van zijn secret en zijn log."
sidebar:
  label: Overzicht
  order: 0
area: settings
feature: webhooks
appPath: /settings/general/webhooks
lastVerified: 2026-11-15
version: "2026-11-10"
audience: admin
related:
  - settings/webhooks/create-a-webhook-secret
  - flows/forms
  - notices
intercom:
  - id: "16858360"
    title: Create a Webhook (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16858360-create-a-webhook-pyn-2
    note: draws on
translation:
  source: settings/webhooks/index.mdx
  sourceSha: dd1218d30155660a0b00aca101164f1e7fc0f495
---

Een inkomende webhook is een adres waar een ander systeem JSON naartoe post. Elke webhook hoort bij een formulier: een payload die binnenkomt wordt een inzending van dat formulier voor de medewerker die in de payload wordt genoemd, en die inzending kan een automation starten. Webhooks worden op het formulier gemaakt, in zijn zijpaneel **Webhook**; Settings toont ze allemaal op één plek.

![Settings > General > Webhooks lists every inbound webhook created on a form.](https://support.pyn.ai/media/settings/webhooks/settings-webhooks-list.png)

## Hoe een webhook werkt

- Het endpoint is `POST /api/webhook/<webhook id>` met de header `Authorization: Bearer <secret>` en een JSON-body. Het paneel toont de **URL** en **Header** om mee te sturen: "Post a JSON body here, with the secret as a bearer token."
- De body vermeldt de medewerker met `subject_id` en de antwoorden onder `fields`. De instelling **Subject** van het formulier zegt uit welk bronsysteem dat id komt, bijvoorbeeld een BambooHR-medewerkers-id.
- Elke aanroep krijgt `202` als antwoord zodra hij is geaccepteerd; het tabblad **History** is het verslag van wat er met elke payload is gebeurd. Items hebben een code zoals `submitted`, `unknown-subject`, `missing-fields`, `invalid-fields`, `ambiguous-fields` of `already-submitted`.
- Stuur een header `Idempotency-Key` mee om herhalingen veilig te maken: een herhaling van dezelfde sleutel krijgt opnieuw `202` als antwoord maar wordt niet een tweede keer verwerkt.
- Een payload die Pyn niet kon aannemen maakt een melding aan in [Notices](https://support.pyn.ai/nl/notices/); een aanroeper die één fout herhaalt werkt één melding bij in plaats van er veel aan te maken. Admins kunnen er ook over worden gemaild; zie [E-mails over meldingen instellen](https://support.pyn.ai/nl/settings/notifications/).
- Een webhook neemt niets aan totdat hij een secret heeft, en een gearchiveerde webhook neemt geen payloads meer aan.

## Wat je hier kunt doen

- [Een webhook-secret maken of vervangen](https://support.pyn.ai/nl/settings/webhooks/create-a-webhook-secret/)
- Een webhook hernoemen vanuit zijn paneel: bewerk de **Title** en druk op Enter, of klik ergens anders, om op te slaan
- De **History** van payloads lezen en het hele log als CSV exporteren vanuit het zijpaneel Webhook van het formulier
- Een webhook archiveren vanuit zijn menu **...**

## Waar het in de app zit

Open `/settings/general/webhooks` in Pyn, of open **Settings** in de primaire navigatie en selecteer **Webhooks** onder **General**. Wil je een webhook maken, open dan het formulier in [Forms](https://support.pyn.ai/nl/flows/forms/), selecteer **Settings** in de balk en dan **Add Webhook**.

## Gerelateerd

- [Een webhook-secret maken of vervangen](https://support.pyn.ai/nl/settings/webhooks/create-a-webhook-secret/) vóór de eerste payload.
- [Forms](https://support.pyn.ai/nl/flows/forms/) om de webhook te maken en zijn subject te kiezen.
- [Notices](https://support.pyn.ai/nl/notices/) voor payloads die Pyn niet kon aannemen.
