---
title: "Zero Retention Buckets | WebhookRelay"
meta:
  "og:description": "Stop storing webhook payloads and headers while keeping a record that each request happened."
  "og:title": "Zero Retention Buckets"
  description: "Stop storing webhook payloads and headers while keeping a record that each request happened."
---

![Stripes](https://webhookrelay.com/docs/webhooks/zero-retention-buckets/images/stripes.svg)

Documentation

**Fundamentals**

# **Zero Retention Buckets**

Stop storing webhook payloads and headers while keeping a record that each request happened.

## [What is a zero retention bucket?](#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](#enable-zero-retention)

1. Open the [Buckets page](https://my.webhookrelay.com/buckets).
2. Open the bucket you want to configure.
3. Select the **Settings** tab.
4. Turn on **Ephemeral**.
5. Click **Save**.

![Bucket settings with Ephemeral enabled](https://webhookrelay.com/docs/webhooks/zero-retention-buckets/images/docs/webhooks/ephemeral_bucket.png)

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](#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.

Did this page help you?