Entregas e atividade dos webhooks
Cada tentativa de entrega e cada alteração a um endpoint, filtradas como a consola as filtra.
Executa qualquer uma das 6 chamadas desta página contra o seu espaço de trabalho, com a sua própria chave.
Entregas
GET /webhooks/{id}/deliveries lê o registo de entregas de um endpoint e GET /webhooks/deliveries o de todos de uma vez, opcionalmente restringido por endpointIds. Ambos aceitam status (failed é o interruptor «só falhadas» da consola), since e until, paginam com limit e cursor, e mantêm o cursor válido com qualquer filtro desde que cada página envie os mesmos. Cada linha traz o seu endpointId. Nada é apagado.
{ "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"}Ler e reenviar uma
GET /webhooks/{id}/deliveries/{deliveryId} devolve o corpo enviado, o que o recetor respondeu e cada tentativa do evento, e POST …/replay volta a enviar esse evento, um de cada vez. O corpo nomeia os endereços de que o evento trata, por isso uma chave restrita a alguns endereços só pode abrir uma entrega num endpoint cujas próprias listas de permissões caibam nas da chave, e ter um endereço nunca cobre o seu domínio inteiro. Por OAuth só o proprietário do espaço de trabalho pode abrir ou reenviar uma, a mesma regra que a consola aplica.
Atividade
GET /webhooks/activity e GET /webhooks/{id}/activity leem o registo de auditoria: created, updated, enabled, disabled, auto_disabled, secret_rotated, tested, replayed e removed. actor nomeia quem o fez, uma pessoa como @username e uma chave como API key <name>, e é null quando a OpenEmail o fez por si. endpointIds, since e until restringem-no, e um endpoint removido mantém o seu histórico.