Événements et statistiques des webhooks
Les événements auxquels un point de terminaison peut s'abonner, et comment se sont passées les livraisons.
Exécute l'un des 2 appels sur votre espace de travail.
Événements
GET /webhooks/events liste chaque événement qu'un point de terminaison peut nommer dans eventTypes, chacun avec une phrase indiquant quand il se déclenche, et les limites auxquelles un point de terminaison est soumis : maxEndpoints pour l'espace de travail, que fixe son offre, et maxAddresses et maxDomains pour une liste d'autorisation. Il demande webhooks:read.
{ "object": "webhook_catalogue", "events": [ { "id": "email.sent", "label": "A message left OpenEmail." }, { "id": "email.bounced", "label": "A message bounced." } ], "maxEndpoints": 10, "maxAddresses": 50, "maxDomains": 20}Un point de terminaison qui ne nomme aucun événement reçoit tous les événements e-mail sauf email.replied : email.replied et les autres familles n'atteignent donc qu'un point de terminaison qui les demande par leur nom.
Statistiques
GET /webhooks/stats lit comment se sont passées les livraisons sur une période, l'onglet Statistiques de la page Webhooks : les tentatives, les livraisons réussies et les échecs, le temps médian qu'un destinataire a mis à répondre, une série d'intervalles, les événements envoyés et les codes de réponse reçus. Il demande webhooks:read. endpointIds le restreint à certains points de terminaison, since et until fixent la période, 30 jours par défaut, et grain et offsetMinutes règlent le découpage de la série. Chaque essai d'un événement compte comme une tentative.
{ "object": "webhook_stats", "since": "2026-09-02T00:00:00.000Z", "until": "2026-10-02T00:00:00.000Z", "grain": "day", "endpointIds": [], "totals": { "attempts": 1280, "delivered": 1266, "failed": 14, "medianDurationMs": 212 }, "buckets": [{ "bucket": "2026-09-28", "delivered": 44, "failed": 1 }], "events": [{ "id": "email.delivered", "count": 702 }], "codes": [{ "id": "200", "count": 1266 }, { "id": "503", "count": 14 }]}