> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ibee.co.in/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ibee.co.in/docs/_mcp/server.

# Event Notifications

> Configure webhook notifications on an IBEE Object Storage bucket to receive real-time POST requests when objects are created or deleted. Filter by prefix or suffix to target specific files.

Event notifications send a POST request to your webhook URL whenever objects are created or deleted in a bucket. Use prefix and suffix filters to target specific paths or file types.

## Before you begin

* An active IBEE Solutions organization with a verified account
* A bucket ([Create a bucket](/docs/infrastructure/object-storage/buckets))
* A publicly accessible HTTPS endpoint to receive webhook POST requests

## Add a webhook notification

### Open bucket settings

Open your bucket in the portal, click the **Settings** tab, then click **Event Notifications**.

### Add a notification

Click **+ Add Notification**. The **Add Notification** modal appears with the subtitle *"Configure webhook endpoint and event types."*

### Configure the webhook

**Webhook URL** (required)

Helper: *"The URL that will receive POST requests when events occur."* Placeholder: `https://your-app.com/`.

```
https://your-app.com/webhook
```

**Event Types** (required)

Helper: *"Select which events should trigger notifications:"*

| Event                        | Description                         |
| ---------------------------- | ----------------------------------- |
| **Creation of a new object** | Triggered when objects are uploaded |
| **Deletion of an object**    | Triggered when objects are deleted  |

At least one event type must be selected.

### Set filters (optional)

Expand **Advanced Options** — *"Filter notifications to specific objects based on prefix or suffix:"*

| Filter     | Placeholder      | Helper                                            |
| ---------- | ---------------- | ------------------------------------------------- |
| **Prefix** | `e.g., uploads/` | Only trigger for objects with this path prefix    |
| **Suffix** | `e.g., .jpg`     | Only trigger for objects with this file extension |

Leave both empty to receive notifications for all objects in the bucket.

### Save

Click **Save Notification**. The webhook appears in the **Webhook Notifications** list.

## Troubleshooting

**Webhook not receiving events**
Ensure the webhook URL is publicly accessible over HTTPS. IBEE sends POST requests — verify your endpoint is not blocking them.

**Too many notifications**
Use the **Prefix** or **Suffix** filters under Advanced Options to limit notifications to specific paths or file types.

**Notifications for wrong event type**
Check that the correct event types (**Creation** and/or **Deletion**) are selected for the notification.

## Related

* [Buckets](/docs/infrastructure/object-storage/buckets)
* [Objects](/docs/infrastructure/object-storage/objects)
* [Lifecycle](/docs/infrastructure/object-storage/buckets/lifecycle-management)
* [Bucket policies](/docs/infrastructure/object-storage/buckets/bucket-policies)