> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Webhooks
export const MultiRelatedLinks = ({sections = []}) => {
if (!sections || sections.length === 0) {
return null;
}
return
{sections.map((section, index) => )}
;
};
export const RelatedLinks = ({title, items = []}) => {
const getBadgeClass = badge => {
if (!badge) return "badge-default";
const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
};
if (!items || items.length === 0) {
return null;
}
return ;
};
Webhooks allow you to monitor Box content for events, and receive notifications
to a URL of your choice when they occur. For example, a workflow may include
waiting for a file to be downloaded to delete a shared link. A webhook can be
set on the file and upon notification of the download event, a script can launch
to make an API call to delete the shared link.
## Versions
There are two types of webhooks: V1 and V2, which are compared below.
For the ease of use, better security, more event triggers to choose from,
and automatic retries we recommend to use V2 webhooks.
| V1 | V2 |
| ------------------------------------------------------- | ---------------------------------------------------------------- |
| Created in the [Developer Console][console]. | Created in the [Developer Console][console] or with an API call. |
| Set at the root level. | Set on specific files/folders, but cannot set at the root. |
| Select from 14 event triggers. | Select from 30+ event triggers. |
| Provides selected callback parameters. | Payload includes full object response & additional context info. |
| No retry mechanism after notification delivery failure. | Retries up to 10 times after notification delivery failure. |
| Does not support payload verification. | Supports payload verification. |
| Notification URL can be HTTP or HTTPS. | Notification URL must be HTTPS. |
| Does not scale well. | Scales well and has increased reliability. |
[console]: https://app.box.com/developers/console