---
title: Ein Webhook-Secret erstellen oder ersetzen
description: Erzeuge das Bearer-Secret, das ein Webhook braucht, bevor er Payloads annimmt, kopiere es einmal und rotiere es, wenn es verloren geht oder offengelegt wurde.
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
---

Ein Webhook wird auf einem Formular erstellt, nimmt aber nichts an, bis er ein Secret hat. Du erzeugst das Secret im Panel des Webhooks, kopierst es in das aufrufende System und ersetzt es, wenn es durchsickert oder das andere System es verliert. Das Secret wird einmal gezeigt und lässt sich nicht erneut auslesen.

## Bevor du beginnst

- Du bist Admin oder Owner.
- Der Webhook existiert. Falls nicht, öffne das Formular in [Forms](https://support.pyn.ai/de/flows/forms/), wähle **Settings** in der Leiste und dann **Add Webhook**.
- Du hast einen sicheren Ort, um das Secret einzufügen, etwa den Zugangsdaten-Speicher des aufrufenden Systems.

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

## Schritte

1. Öffne in Pyn **Settings** in der linken Navigation, dann **Webhooks** unter **General**.

2. Wähle den Webhook. Sein Panel öffnet sich; ohne Secret sagt es „This webhook accepts nothing until it has a secret.“

3. Wähle **Create Secret**. Das Panel zeigt das Secret mit „Copy this secret now. It is shown once and cannot be retrieved later.“ Lässt sich das Secret nicht erzeugen, zeigt ein Toast **Could not create the secret** und das Panel bleibt, wie es war.

4. Kopiere es, speichere es im aufrufenden System und wähle dann **Done**.

5. Kopiere die **URL**, die unter „Post a JSON body here, with the secret as a bearer token.“ gezeigt wird, und konfiguriere den Aufrufer so, dass er `Authorization: Bearer <secret>` mit einem JSON-Body sendet.

6. Um später zu rotieren, wähle **Replace Secret**. Die Bestätigung warnt „The current secret stops working immediately. Anything calling this webhook will need the new one.“ Wähle **Replace** und kopiere den neuen Wert. Lässt sich das Secret nicht ersetzen, zeigt ein Toast **Could not replace the secret** und das alte funktioniert weiter.

> **Caution:** Das Ersetzen wirkt in dem Moment, in dem du bestätigst. Aktualisiere das aufrufende System direkt danach, sonst wird seine nächste Payload abgelehnt.

## Was du sehen solltest

Mit einem Secret zeigt das Panel „This webhook already has a secret. Replace it if the old one has been lost.“ Sende eine Test-Payload aus dem anderen System: Der Tab **History** listet sie innerhalb weniger Sekunden mit ihrem Ergebnis, `submitted` für eine Payload, die zu einer Einsendung wurde, oder einen Grund-Code wie `unknown-subject`. Eine Payload mit falschem oder fehlendem Secret wird mit `404` beantwortet und erscheint nicht im Protokoll.

## Verwandte Seiten

- [Webhooks](https://support.pyn.ai/de/settings/webhooks/) für die Form der Payload und die Ergebnis-Codes.
- [Forms](https://support.pyn.ai/de/flows/forms/), um den Webhook zu erstellen und sein Subject zu setzen.
