Een webhook-secret maken of vervangen
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
Section titled “Voordat je begint”- Je bent admin of owner.
- De webhook bestaat. Zo niet, open dan het formulier in 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.

Stappen
Section titled “Stappen”-
Open in Pyn Settings in de linkernavigatie, dan Webhooks onder General.
-
Selecteer de webhook. Zijn paneel opent; zonder secret zegt het “This webhook accepts nothing until it has a secret.”
-
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.
-
Kopieer het, bewaar het in het aanroepende systeem, en selecteer dan Done.
-
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. -
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.
Wat je zou moeten zien
Section titled “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.