Shared Link Created
Triggers a flow when a shared link is created in Box.
Options
Field | Definition | Type | Required |
---|---|---|---|
Target ItemType | Choose the type of Webhook that will be applied:
|
Dropdown |
TRUE |
Target Item ID | Unique ID of the item to which the Webhook will be applied. |
Text |
TRUE |
Output
Field | Definition | Type |
---|---|---|
Event | ||
Event ID | Unique identifier of the event |
Text |
Event Type |
Type of event that created this file.
For example, Webhook Event. |
Text |
Event Time | Date and time when the event was triggered in Box. |
Date & Time |
Webhook ID | Unique identifier of the Webhook that triggered this event. |
Text |
Event | Name of an event that triggered the event. |
Text |
Shared Link | ||
Share URL | URL that can be used to access the item on Box. |
Text |
Download URL | URL that can be used to download the file. This URL can be used in a browser to download the file. This URL includes the file extension so that the file will be saved with the right file type. |
Text |
Vanity URL | Custom URL that can also be used to preview the item on Box. Custom URLs can only be created or modified in the Box Web application. |
Text |
Vanity Name | Custom vanity name to use in the Vanity URL. |
Text |
Effective Access | Effective access level for the shared link. This can be a more restrictive access level than the value in the access field when the enterprise settings restrict the allowed access levels. |
Text |
Effective Permission | Effective permissions for this shared link. |
Text |
Password Enabled? | True if the shared link requires a password to access the item; otherwise, False. |
True/False |
Time Unshared | Date and time when this link was unshared. |
Date & Time |
Download Count | Number of times this item has been downloaded. |
Number |
Preview Count | Number of times this item has been previewed. |
Number |
Access Level | Accessibility of the share link. |
Text |
Can Download? | True if the shared link allows for the item to be downloaded; otherwise, False. For shared links on folders, this also applies to any items in the folder. |
True/False |
Can Preview? | True if the shared link allows for the item to be previewed; otherwise, False. For shared links on folders this also applies to any items in the folder. |
True/False |
Shared Item ID | Unique identifier of the item for Shared Link. |
Text |
Share Item Type | Type of Item for Shared Link. |
Text |
Created By | ||
Name | Name of user who created the Share Link. |
Text |
User ID | Unique identifier of the user who last created the Share Link. |
Text |
Email address of the user who created the Share Link. |
Text |
|
Additional Info | ||
Additional Info | Additional information which Box can return. |
Object |
Context | ||
Execution ID | Execution identifier of the Webhook event. |
Text |
Additional information
Note the following limitations:
-
One Webhook per item (for example, file or folder) per application per authenticated user.
-
1000 Webhooks per application per user.
-
Webhooks cannot be triggered on the root folders.
After a shared link is created, if you decide to edit the properties of the shared link, you need to use the Shared Link Updated card.