Créer un secret de signature
Sans secret **actif**, aucune notification n'est émise : la tentative est journalisée en `SKIPPED_NO_SECRET` et rejouée, mais si la chaîne s'épuise avant qu'un secret existe, l'issue ne vous sera pas poussée. Le secret n'est affiché qu'à cette réponse. Créer un secret n'invalide pas les précédents, et ne bascule pas non plus la signature : c'est le **plus ancien** secret actif qui signe, jusqu'à sa révocation. La rotation est donc « créer, déployer le nouveau vérificateur, révoquer l'ancien ».
Clé d'API de l'organisation, envoyée en Authorization: Bearer sk_live_… (sk_test_… sur le serveur Sandbox). Il n'existe aucun header X-API-Key.
In: header
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/webhook-secrets"{ "success": true, "message": "string", "data": { "secretId": "string", "secretKey": "string" }}Lister les secrets de signature actifs GET
Les secrets actifs de votre organisation, du plus récent au plus ancien. La clé `whsec_…` elle-même n'est jamais renvoyée : seul son `secretId` et sa date de création. Le secret qui signe effectivement est le **plus ancien** de cette liste.
Révoquer un secret de signature DELETE
Révoquer le dernier secret actif **coupe toutes les notifications** : sans secret actif, rien n'est émis. Créez le remplaçant avant de révoquer.