웹훅 전송과 활동

GET /webhooks/{id}/deliveries는 엔드포인트 하나의 전송 로그를, GET /webhooks/deliveries는 모든 엔드포인트의 로그를 한 번에 읽으며, endpointIds로 좁힐 수도 있습니다. 둘 다 status(failed는 콘솔의 「실패만」 스위치), since, until을 받고, limit과 cursor로 페이지를 넘기며, 각 페이지가 같은 필터를 보내는 한 어떤 필터에서도 커서가 유효합니다. 각 행에는 endpointId가 붙습니다. 아무것도 지워지지 않습니다.

{  "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"}

GET /webhooks/{id}/deliveries/{deliveryId}는 보낸 본문, 수신자의 응답, 이벤트의 모든 시도를 돌려주고, POST …/replay는 그 이벤트를 하나씩 다시 보냅니다. 본문에는 이벤트가 다루는 주소가 들어 있으므로, 일부 주소로 좁혀진 키는 자기 허용 목록이 키의 목록 안에 드는 엔드포인트에서만 전송을 열 수 있고, 주소 하나를 가졌다고 그 도메인 전체를 가진 것은 아닙니다. OAuth로는 워크스페이스 소유자만 전송을 열거나 다시 보낼 수 있으며, 콘솔과 같은 규칙입니다.

GET /webhooks/activity와 GET /webhooks/{id}/activity는 감사 로그를 읽습니다: created, updated, enabled, disabled, auto_disabled, secret_rotated, tested, replayed, removed. actor는 누가 했는지를 알려 주며, 사람은 @username, 키는 API key <name>으로 나타내고, OpenEmail이 스스로 한 경우에는 null입니다. endpointIds, since, until로 좁힐 수 있고, 삭제된 엔드포인트도 기록을 유지합니다.