# API Webhooks
SUMMARY: Enregistrez des rappels HTTP pour les événements de mémoire, chat et tâches — soyez notifié quand les données changent.

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

API Webhooks
Les webhooks permettent de recevoir des rappels HTTP lorsque des événements se
produisent dans Synapse. Parfait pour déclencher des automatisations externes, envoyer
des notifications ou synchroniser vers d'autres systèmes.
Endpoints
POST /webhooks
Enregistre un nouveau webhook.
[CODE BLOCK]
Réponse :
[CODE BLOCK]
GET /webhooks
Liste tous les webhooks du mind courant.
[CODE BLOCK]
GET /webhooks/:id
Récupère un seul webhook.
[CODE BLOCK]
PUT /webhooks/:id
Met à jour un webhook (URL, événements, secret ou drapeau enabled).
[CODE BLOCK]
DELETE /webhooks/:id
Supprime un webhook.
[CODE BLOCK]
Types d'événements
| Schéma | Se déclenche quand |
|---------|------------|
|  | Tout événement de mémoire |
|  | Nouvelle mémoire stockée |
|  | Mémoire mise à jour |
|  | Mémoire supprimée |
|  | Tout événement de chat |
|  | Nouveau message de l'humain |
|  | Tout événement de tâche |
|  | Nouvelle tâche créée |
|  | Tâche marquée comme terminée |
|  | Tous les événements |
Payload du webhook
Lorsqu'un événement se déclenche, Synapse envoie un POST vers votre URL :
[CODE BLOCK]
Vérification de signature
Si vous définissez un , Synapse signe chaque payload avec HMAC-SHA256 :
[CODE BLOCK]
Vérifiez dans votre gestionnaire :
[CODE BLOCK]
Schéma : synchronisation en temps réel
[CODE BLOCK]
Prochaines étapes
- Cron & Scheduler
- Guide d'automatisation par webhooks