# Webhooks API
SUMMARY: メモリ、チャット、タスクイベントに対する HTTP コールバックの登録 — データ変更時に通知を受信。

KEY CONTEXT:
Auth: Mind Key
Register: POST /webhooks { url, events, secret? }
List: GET /webhooks
Get: GET /webhooks/:id
Update: PUT /webhooks/:id { url?, events?, secret?, enabled? }
Delete: DELETE /webhooks/:id
Events: memory.*, memory.store, memory.update, memory.delete, chat.*, chat.message_received, task.*, task.created, task.completed
Secret: HMAC-SHA256 signed payload, sent in X-Synapse-Signature header
Pattern: register webhook → receive POST → process event → call Synapse API

Webhooks API
Webhooks を使用すると、Synapse でイベントが発生した際に HTTP コールバックを受信できます。外部自動化のトリガー、通知の送信、他システムへの同期に最適です。
エンドポイント
POST /webhooks
新しい Webhook を登録します。
[CODE BLOCK]
レスポンス：
[CODE BLOCK]
GET /webhooks
現在の mind のすべての Webhook を一覧表示します。
[CODE BLOCK]
GET /webhooks/:id
単一の Webhook を取得します。
[CODE BLOCK]
PUT /webhooks/:id
Webhook を更新します（URL、events、secret、enabled フラグ）。
[CODE BLOCK]
DELETE /webhooks/:id
Webhook を削除します。
[CODE BLOCK]
イベント種別
| パターン | 発生タイミング |
|---------|------------|
|  | 任意のメモリイベント |
|  | 新規メモリの保存 |
|  | メモリの更新 |
|  | メモリの削除 |
|  | 任意のチャットイベント |
|  | 人間からの新規メッセージ |
|  | 任意のタスクイベント |
|  | 新規タスクの作成 |
|  | タスクの完了マーク |
|  | 全イベント |
Webhook ペイロード
イベント発生時、Synapse はあなたの URL に POST リクエストを送信します。
[CODE BLOCK]
署名検証
 を設定すると、Synapse は各ペイロードを HMAC-SHA256 で署名します。
[CODE BLOCK]
ハンドラで検証します：
[CODE BLOCK]
パターン：リアルタイム同期
[CODE BLOCK]
次のステップ
- Cron & Scheduler
- Webhook Automation Guide