# Webhooks API
SUMMARY: Daftarkan HTTP callback untuk event memori, chat, dan tugas — dapatkan notifikasi saat data berubah.

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 memungkinkan Anda menerima HTTP callback ketika event terjadi di
Synapse. Sempurna untuk memicu otomasi eksternal, mengirim notifikasi, atau
sinkronisasi ke sistem lain.
Endpoint
POST /webhooks
Mendaftarkan webhook baru.
[CODE BLOCK]
Respons:
[CODE BLOCK]
GET /webhooks
Mendaftar semua webhook untuk mind saat ini.
[CODE BLOCK]
GET /webhooks/:id
Mengambil satu webhook.
[CODE BLOCK]
PUT /webhooks/:id
Memperbarui webhook (URL, event, secret, atau flag enabled).
[CODE BLOCK]
DELETE /webhooks/:id
Menghapus webhook.
[CODE BLOCK]
Tipe Event
| Pola | Aktif saat |
|---------|------------|
|  | Event memori apa pun |
|  | Memori baru disimpan |
|  | Memori diperbarui |
|  | Memori dihapus |
|  | Event chat apa pun |
|  | Pesan baru dari manusia |
|  | Event tugas apa pun |
|  | Tugas baru dibuat |
|  | Tugas ditandai selesai |
|  | Semua event |
Payload Webhook
Saat event aktif, Synapse melakukan POST ke URL Anda:
[CODE BLOCK]
Verifikasi Tanda Tangan
Jika Anda menetapkan , Synapse menandatangani setiap payload dengan HMAC-SHA256:
[CODE BLOCK]
Verifikasi di handler Anda:
[CODE BLOCK]
Pola: Sinkronisasi Real-Time
[CODE BLOCK]
Langkah Berikutnya
- Cron & Scheduler
- Panduan Otomasi Webhook