> For the complete documentation index, see [llms.txt](https://docs.couchdrop.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.couchdrop.io/administration/alerts-and-notifications/file-activity-alerts.md).
# File Activity Alerts
File Activity Alerts notify you when file operations occur in Couchdrop.
## Overview
Couchdrop can send alerts when file activity or transfer failures occur.
File activity alerts can be configured globally across your Couchdrop account or for a specific folder. Depending on the event, notifications can be delivered by email or webhook.
{% hint style="info" %}
### Webhook delivery
Couchdrop expects notification webhook endpoints to return an HTTP `200` response.
If Couchdrop does not receive an HTTP `200` response, it retries the webhook up to 15 times using exponential backoff.
For more advanced webhook-based workflows, use File Actions.
{% endhint %}
### Global or folder alerts
Use **Global File Activity Alerts** when you want visibility across the account.
Use **Folder File Activity Alerts** when notifications should only apply to a particular folder or directory structure.
You can use both where required. For example, you might configure global failure alerts for operational monitoring while sending upload notifications from a specific customer folder to another recipient.
## Supported file activity events
Couchdrop supports alerts for the following file events:
| Event | Email | Webhook |
|---|
| Upload | Yes | Yes |
| Download | Yes | Yes |
| Failure | Yes | Yes |
| Deletion | No | Yes |
| Rename | No | Yes |
| Storage Failure | Yes | No |
The available events depend on whether you configure the alert globally or on a specific folder.
### Upload
Upload alerts notify you when a file is uploaded to Couchdrop.
They can be configured:
* Globally by email
* Globally by webhook
* On an individual folder by email
* On an individual folder by webhook
#### Global upload alerts
Navigate to **Admin Mode > Alerting**.
Under **Email Notifications**, enable **Send email on Upload** and enter the required **Recipient Email Address**.
To send upload events to a webhook instead, enable **Send notification on Upload** under **Webhooks** and enter the **Recipient Webhook URI**.
#### Folder upload alerts
In the **File Browser**, open **Manage Folder > Notifications**.
Under **Email Notifications**, enable **Send email on Upload** and enter the required **Email Address**.
For webhook notifications, enable **Send notification on Upload** and enter the **Webhook URI**.
Folder notifications apply to the selected folder and its children.
### Download
Download alerts notify you when a file is downloaded.
They can be configured:
* Globally by email
* Globally by webhook
* On an individual folder by email
* On an individual folder by webhook
#### Global download alerts
Navigate to **Admin Mode > Alerting**.
Under **Email Notifications**, enable **Send email on Download** and enter the required **Recipient Email Address**.
For webhook notifications, enable **Send notification on Download** and enter the **Recipient Webhook URI**.
#### Folder download alerts
In the **File Browser**, open **Manage Folder > Notifications**.
Enable **Send email on Download** for email notifications, or **Send notification on Download** for webhook notifications.
Configure the corresponding **Email Address** or **Webhook URI**.
### Failure
Failure alerts notify you when an event fails.
They can be configured globally or against an individual folder.
#### Global failure alerts
Navigate to **Admin Mode > Alerting**.
Under **Email Notifications**, enable **Send email on Failure**.
For webhook notifications, enable **Send notification on Failure**.
Configure the required recipient email address or webhook endpoint.
#### Folder failure alerts
In the **File Browser**, open **Manage Folder > Notifications**.
You can enable:
* **Send email on Failure**
* **Send notification on Failure**
Enter the appropriate **Email Address** or **Webhook URI**.
### File deletion
Couchdrop can send a webhook notification when a file is deleted.
Navigate to **Admin Mode > Alerting**.
Under **Webhooks**, enable **Send notification on Deletion** and enter the **Recipient Webhook URI**.
Deletion alerts are available through global webhook notifications.
### File rename
Couchdrop can send a webhook notification when a file is renamed.
Navigate to **Admin Mode > Alerting**.
Under **Webhooks**, enable **Send notification on Rename** and enter the **Recipient Webhook URI**.
Rename alerts are available through global webhook notifications.
### Storage failure
Storage failure alerts notify you when Couchdrop detects a storage failure.
Navigate to **Admin Mode > Alerting** and enable **Send email on Storage Failure**.
The recipient for storage failure alerts is automatically determined by Couchdrop.
Storage failure notifications are available through email.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.couchdrop.io/administration/alerts-and-notifications/file-activity-alerts.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.