Eventos y estadísticas de webhooks
Los eventos a los que puede suscribirse un endpoint y cómo fueron las entregas.
Ejecuta cualquiera de las 2 llamadas en tu espacio de trabajo.
Eventos
GET /webhooks/events lista cada evento que un endpoint puede nombrar en eventTypes, cada uno con una frase que dice cuándo se dispara, y los límites a los que está sujeto un endpoint: maxEndpoints para el espacio de trabajo, que decide su plan, y maxAddresses y maxDomains para una lista de permitidos. Necesita 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 endpoint que no nombra ningún evento recibe todos los eventos de correo salvo email.replied, así que email.replied y las demás familias solo llegan a un endpoint que los pide por su nombre.
Estadísticas
GET /webhooks/stats lee cómo fueron las entregas en un periodo, la pestaña Analíticas de la página Webhooks: los intentos, las entregadas y las fallidas, la mediana del tiempo que tardó un receptor en responder, una serie de intervalos, los eventos enviados y los códigos de respuesta recibidos. Necesita webhooks:read. endpointIds lo acota a algunos endpoints, since y until fijan el periodo, 30 días por defecto, y grain y offsetMinutes dan forma a la serie. Cada vez que se intenta entregar un evento cuenta como un intento.
{ "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 }]}