Zero Retention Buckets
Stop storing webhook payloads and headers while keeping a record that each request happened.
What is a zero retention bucket?
Enable the Ephemeral setting on a bucket when you need to process webhooks without retaining their contents. Webhook Relay records that a request happened, but does not persist the request body, request headers, response body, or response headers.
This can help reduce the amount of webhook data stored by Webhook Relay when you only need the bucket to receive and forward requests in real time.
Enable zero retention
- Open the Buckets page.
- Open the bucket you want to configure.
- Select the Settings tab.
- Turn on Ephemeral.
- Click Save.
Once enabled, the bucket keeps only a record that the request occurred. Its request and response contents are not retained for later inspection.
Important: retries are not available
Because an ephemeral bucket does not persist the request or response data, Webhook Relay cannot retry a request after the initial delivery attempt. Enable Ephemeral only when you do not need retry support or access to the request contents after delivery.