# tigris buckets set-notifications

Configure object event notifications on a bucket. Sends webhook requests to a URL when objects are created, updated, or deleted.

## Usage[​](#usage "Direct link to Usage")

```
tigris buckets set-notifications <name> [flags]

t3 b set-notifications <name> [flags]
```

## Flags[​](#flags "Direct link to Flags")

| Name         | Required | Default | Description                                                                      |
| ------------ | -------- | ------- | -------------------------------------------------------------------------------- |
| `--url`      | No       | —       | Webhook URL to send notifications to (must be http or https)                     |
| `--filter`   | No       | —       | SQL WHERE clause to filter events by key (e.g. ``WHERE `key` REGEXP "^images"``) |
| `--token`    | No       | —       | Token for webhook authentication                                                 |
| `--username` | No       | —       | Username for basic webhook authentication                                        |
| `--password` | No       | —       | Password for basic webhook authentication                                        |
| `--enable`   | No       | —       | Enable notifications on the bucket (uses existing config)                        |
| `--disable`  | No       | —       | Disable notifications on the bucket (preserves existing config)                  |
| `--reset`    | No       | —       | Clear all notification settings on the bucket                                    |

## Examples[​](#examples "Direct link to Examples")

```
# Set up webhook notifications

tigris buckets set-notifications my-bucket --url https://example.com/webhook



# With token authentication

tigris buckets set-notifications my-bucket --url https://example.com/webhook --token secret123



# With basic authentication

tigris buckets set-notifications my-bucket --url https://example.com/webhook --username admin --password secret



# Only receive notifications for keys with the prefix images/

tigris buckets set-notifications my-bucket --url https://example.com/webhook --filter 'WHERE `key` REGEXP "^images"'



# Enable existing notification config

tigris buckets set-notifications my-bucket --enable



# Disable notifications (preserves config)

tigris buckets set-notifications my-bucket --disable



# Clear all notification settings

tigris buckets set-notifications my-bucket --reset
```