StorageObject Storage

Event Notifications

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 Cloud project with a verified account
  • A bucket (Create a bucket)
  • A publicly accessible HTTPS endpoint to receive webhook POST requests

Add a webhook notification

1

Open bucket settings

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

2

Add a notification

Click + Add Notification.

3

Configure the webhook

Webhook URL (required)

Enter the URL that will receive POST requests when events occur:

https://your-app.com/webhook

Event Types (required)

Select which events trigger the notification:

EventDescription
Creation of a new objectTriggered when objects are uploaded
Deletion of an objectTriggered when objects are deleted

At least one event type must be selected.

4

Set filters (optional)

Expand Advanced Options to filter notifications to specific objects:

FilterExampleBehaviour
Prefixuploads/Only trigger for objects whose key starts with this prefix
Suffix.jpgOnly trigger for objects whose key ends with this suffix

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

5

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.