Webhook の配信とアクティビティ

GET /webhooks/{id}/deliveries は 1 つのエンドポイントの配信ログを、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 はそのイベントを 1 件ずつ再送する。本文にはイベントの対象アドレスが含まれるため、一部のアドレスに絞り込まれたキーが配信を開けるのは、自身の許可リストがキーのリストの内側に収まるエンドポイントだけで、1 アドレスを持っていてもそのドメイン全体を持つことにはならない。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 で絞り込め、削除されたエンドポイントも履歴を保つ。