API REST

Endpoint : Webhooks

Créer, lister et supprimer des abonnements webhook via l'API.

Les webhooks vous permettent de recevoir des notifications HTTP à chaque événement Coffrify (transfert créé, téléchargé, expiré…). Vous pouvez en créer depuis l'API ou depuis le Dashboard.

POST /v1/webhooks - Créer

POST/v1/webhooksCrée un abonnement webhook et retourne le secret de signature HMAC.

// Corps
{
  "url":    "https://api.monapp.com/webhooks/coffrify",
  "events": ["transfer.completed", "transfer.expired", "transfer.deleted"],
  "description": "Production endpoint"
}

// Réponse 201
{
  "id":          "wh_01JXXXXXXXXXXXXXXXX",
  "url":         "https://api.monapp.com/webhooks/coffrify",
  "events":      ["transfer.completed", "transfer.expired", "transfer.deleted"],
  "secret":      "whsec_xxxxxxxxxxxxxxxxxxxx",
  "status":      "active",
  "created_at":  "2026-05-26T10:00:00Z"
}

Secret visible une seule fois

Le `secret` de signature est retourné uniquement à la création. Stockez-le immédiatement dans vos variables d'environnement - il ne peut pas être récupéré ensuite.

GET /v1/webhooks - Lister

GET/v1/webhooksListe tous les webhooks actifs du workspace.

DELETE /v1/webhooks/:id - Supprimer

DELETE/v1/webhooks/:idDésactive et supprime le webhook. Les events en cours de livraison sont abandonnés.

Tester un webhook

Depuis le Dashboard → **Webhooks**, cliquez sur **Envoyer un test** pour déclencher un event `ping` vers votre endpoint. Vous pouvez aussi simuler depuis l'API :

POST /v1/webhooks/:id/test
Authorization: Bearer cof_live_sk_...