Webhook-Zustellungen und Aktivität

GET /webhooks/{id}/deliveries liest das Zustellprotokoll eines Endpunkts und GET /webhooks/deliveries das aller Endpunkte auf einmal, optional eingegrenzt durch endpointIds. Beide nehmen status (failed ist der Schalter „nur fehlgeschlagene“ der Konsole), since und until, blättern mit limit und cursor und halten den Cursor unter jedem Filter gültig, solange jede Seite dieselben sendet. Jede Zeile trägt ihre endpointId. Nichts wird gelöscht.

{  "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} gibt den gesendeten Inhalt, die Antwort des Empfängers und jeden Versuch des Ereignisses zurück, und POST …/replay sendet dieses Ereignis erneut, eines nach dem anderen. Der Inhalt nennt die Adressen, um die es geht, deshalb darf ein auf bestimmte Adressen eingegrenzter Schlüssel eine Zustellung nur an einem Endpunkt öffnen, dessen eigene Allowlists innerhalb seiner liegen, und eine einzelne Adresse deckt nie ihre ganze Domain ab. Über OAuth darf nur der Eigentümer des Workspace eine öffnen oder erneut senden, dieselbe Regel wie in der Konsole.

GET /webhooks/activity und GET /webhooks/{id}/activity lesen das Audit-Protokoll: created, updated, enabled, disabled, auto_disabled, secret_rotated, tested, replayed und removed. actor nennt, wer es getan hat, eine Person als @username und einen Schlüssel als API key <name>, und ist null, wenn OpenEmail es von selbst getan hat. endpointIds, since und until grenzen es ein, und ein entfernter Endpunkt behält seinen Verlauf.