Ir a la documentación
API

Entregas y actividad de webhooks

Cada intento de entrega y cada cambio en un endpoint, filtrados como los filtra la consola.

GETapi.openemail.uk/webhooks/deliveries

Ejecuta cualquiera de las 6 llamadas de esta página contra tu espacio de trabajo, con tu propia clave.

Entregas

GET /webhooks/{id}/deliveries lee el registro de entregas de un endpoint y GET /webhooks/deliveries el de todos a la vez, opcionalmente acotado por endpointIds. Ambos aceptan status (failed es el interruptor «solo fallidas» de la consola), since y until, paginan con limit y cursor, y mantienen el cursor válido con cualquier filtro mientras cada página envíe los mismos. Cada fila lleva su endpointId. Nada se poda.

GET /webhooks/deliveries?status=failed&since=2026-09-22T00:00:00Z
{  "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"}

Leer y reenviar una

GET /webhooks/{id}/deliveries/{deliveryId} devuelve el cuerpo que se envió, lo que respondió el receptor y cada intento del evento, y POST …/replay vuelve a enviar ese evento, uno cada vez. El cuerpo nombra las direcciones de las que trata el evento, así que una clave acotada a algunas direcciones solo puede abrir una entrega en un endpoint cuyas propias listas de permitidos queden dentro de las de la clave, y tener una dirección nunca cubre su dominio entero. Por OAuth solo el propietario del espacio de trabajo puede abrir o reenviar una, la misma regla que aplica la consola.

Actividad

GET /webhooks/activity y GET /webhooks/{id}/activity leen el registro de auditoría: created, updated, enabled, disabled, auto_disabled, secret_rotated, tested, replayed y removed. actor nombra quién lo hizo, una persona como @username y una clave como API key <name>, y es null cuando OpenEmail lo hizo por su cuenta. endpointIds, since y until lo acotan, y un endpoint eliminado conserva su historial.