---
title: Een webhook-secret maken of vervangen
description: Maak het bearer-secret aan dat een webhook nodig heeft voordat hij payloads aanneemt, kopieer het één keer, en roteer het wanneer het kwijt of gelekt is.
sidebar:
  order: 2
area: settings
feature: webhooks
appPath: /settings/general/webhooks
lastVerified: 2026-11-02
version: "2026-10-30"
audience: admin
related:
  - settings/webhooks
  - flows/forms
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/create-a-webhook-secret.mdx
  sourceSha: 132b69427936f3533202abf3fcb53c5ab17e51b5
---

Een webhook wordt op een formulier gemaakt maar neemt niets aan totdat hij een secret heeft. Je maakt het secret aan vanuit het paneel van de webhook, kopieert het naar het aanroepende systeem, en vervangt het als het lekt of het andere systeem het kwijtraakt. Het secret wordt één keer getoond en kan niet worden teruggelezen.

## Voordat je begint

- Je bent admin of owner.
- De webhook bestaat. Zo niet, open dan het formulier in [Forms](https://support.pyn.ai/nl/flows/forms/), selecteer **Settings** in de balk en dan **Add Webhook**.
- Je hebt een veilige plek om het secret te plakken, zoals de credential store van het aanroepende systeem.

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

## Stappen

1. Open in Pyn **Settings** in de linkernavigatie, dan **Webhooks** onder **General**.

2. Selecteer de webhook. Zijn paneel opent; zonder secret zegt het "This webhook accepts nothing until it has a secret."

3. Selecteer **Create Secret**. Het paneel toont het secret met "Copy this secret now. It is shown once and cannot be retrieved later." Kan het secret niet worden aangemaakt, dan meldt een toast **Could not create the secret** en blijft het paneel zoals het was.

4. Kopieer het, bewaar het in het aanroepende systeem, en selecteer dan **Done**.

5. Kopieer de **URL** onder "Post a JSON body here, with the secret as a bearer token." en stel de aanroeper zo in dat die `Authorization: Bearer <secret>` met een JSON-body meestuurt.

6. Wil je later roteren, selecteer dan **Replace Secret**. De bevestiging waarschuwt "The current secret stops working immediately. Anything calling this webhook will need the new one." Selecteer **Replace** en kopieer de nieuwe waarde. Kan het secret niet worden vervangen, dan meldt een toast **Could not replace the secret** en blijft het oude werken.

> **Caution:** Vervangen gaat in op het moment dat je bevestigt. Werk het aanroepende systeem direct daarna bij, anders wordt zijn volgende payload geweigerd.

## Wat je zou moeten zien

Is er een secret, dan leest het paneel "This webhook already has a secret. Replace it if the old one has been lost." Stuur een testpayload vanuit het andere systeem: het tabblad **History** toont hem binnen een paar seconden met zijn uitkomst, `submitted` voor een payload die een inzending werd, of een redencode zoals `unknown-subject`. Een payload die met een verkeerd of ontbrekend secret is verstuurd krijgt `404` als antwoord en verschijnt niet in het log.

## Gerelateerd

- [Webhooks](https://support.pyn.ai/nl/settings/webhooks/) voor de vorm van de payload en de uitkomstcodes.
- [Forms](https://support.pyn.ai/nl/flows/forms/) om de webhook te maken en zijn subject in te stellen.
