Livraisons et activité des webhooks
Chaque tentative de livraison et chaque modification d'un point de terminaison, filtrées comme la console les filtre.
Exécute n'importe lequel des 6 appels de cette page sur votre espace de travail, avec votre propre clé.
Livraisons
GET /webhooks/{id}/deliveries lit le journal de livraison d'un point de terminaison et GET /webhooks/deliveries celui de tous à la fois, éventuellement restreint par endpointIds. Les deux acceptent status (failed est l'interrupteur « échecs seulement » de la console), since et until, paginent avec limit et cursor, et gardent le curseur valide quel que soit le filtre tant que chaque page envoie les mêmes. Chaque ligne porte son endpointId. Rien n'est purgé.
{ "object": "list", "data": [ { "object": "webhook_delivery", "id": "whd_8c1e4a7f2b9d3e6a0c5f1b28", "endpointId": "whe_3f9c2a7b1e4d8f60a5c7b92d", "eventType": "email.bounced", "status": "failed", "responseCode": 503, "attempt": 2, "maxAttempts": 8, "nextAttemptAt": "2026-09-23T10:35:00.000Z" } ], "hasMore": true, "nextCursor": "whd_8c1e4a7f2b9d3e6a0c5f1b28"}Lire et rejouer une livraison
GET /webhooks/{id}/deliveries/{deliveryId} renvoie le corps envoyé, la réponse du destinataire et chaque tentative de l'événement, et POST …/replay renvoie cet événement, un à la fois. Le corps nomme les adresses concernées par l'événement, donc une clé restreinte à certaines adresses ne peut ouvrir une livraison que sur un point de terminaison dont les propres listes d'autorisation tiennent dans celles de la clé, et détenir une adresse ne couvre jamais tout son domaine. Par OAuth, seul le propriétaire de l'espace de travail peut en ouvrir ou en rejouer une, la même règle que la console.
Activité
GET /webhooks/activity et GET /webhooks/{id}/activity lisent le journal d'audit : created, updated, enabled, disabled, auto_disabled, secret_rotated, tested, replayed et removed. actor indique qui l'a fait, une personne en @username et une clé en API key <name>, et vaut null quand OpenEmail l'a fait de lui-même. endpointIds, since et until le restreignent, et un point de terminaison supprimé garde son historique.