---
title: Webhookシークレットを作成または置き換える
description: Webhookがペイロードを受け付けるために必要なベアラーシークレットを発行し、一度だけコピーして、紛失や漏えいのときにローテーションします。
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
---

Webhookはフォームで作成しますが、シークレットを持つまで何も受け付けません。Webhookのパネルからシークレットを発行し、呼び出し側のシステムにコピーし、漏えいしたり相手のシステムが紛失したりしたら置き換えます。シークレットは一度だけ表示され、あとから読み返すことはできません。

## 始める前に

- あなたが管理者またはオーナーであること。
- Webhookが存在すること。なければ、[フォーム](https://support.pyn.ai/ja/flows/forms/)でフォームを開き、レールの**Settings**を選んでから**Add Webhook**を選びます。
- 呼び出し側のシステムの資格情報ストアなど、シークレットを安全に貼り付けられる場所があること。

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

## 手順

1. Pynで左のナビゲーションの**Settings**を開き、**General**の下の**Webhooks**を開きます。

2. Webhookを選びます。パネルが開きます。シークレットがなければ「This webhook accepts nothing until it has a secret.」と表示されます。

3. **Create Secret**を選びます。パネルにシークレットが「Copy this secret now. It is shown once and cannot be retrieved later.」とともに表示されます。シークレットを発行できない場合は、**Could not create the secret**というトーストが表示され、パネルは元のままです。

4. コピーして呼び出し側のシステムに保存し、**Done**を選びます。

5. 「Post a JSON body here, with the secret as a bearer token.」の下に表示される**URL**をコピーし、呼び出し側が`Authorization: Bearer <secret>`とJSONのボディを送るように設定します。

6. あとでローテーションするには、**Replace Secret**を選びます。確認には「The current secret stops working immediately. Anything calling this webhook will need the new one.」という警告が表示されます。**Replace**を選び、新しい値をコピーします。シークレットを置き換えられない場合は、**Could not replace the secret**というトーストが表示され、古いシークレットは引き続き使えます。

> **Caution:** 置き換えは確定した瞬間に有効になります。呼び出し側のシステムをすぐに更新してください。さもないと、次のペイロードは拒否されます。

## 確認できること

シークレットがある状態では、パネルに「This webhook already has a secret. Replace it if the old one has been lost.」と表示されます。相手のシステムからテストのペイロードを送ってください。**History**タブに数秒以内にその結果とともに表示されます。送信になったペイロードには`submitted`、そうでなければ`unknown-subject`などの理由コードです。間違ったシークレットやシークレットなしで送られたペイロードには`404`が返り、ログには現れません。

## 関連ページ

- [Webhook](https://support.pyn.ai/ja/settings/webhooks/)：ペイロードの形と結果のコードについてです。
- [フォーム](https://support.pyn.ai/ja/flows/forms/)：Webhookを作成してサブジェクトを設定するにはこちらです。
