File Uploaded
Triggers a flow when a file is uploaded, created or moved to a folder in Box.
Options
| Field | Definition | Type | Required |
|---|---|---|---|
|
Folder ID |
Unique ID of the folder. |
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 |
|
File |
||
|
File Name |
Name of the file. |
Text |
|
File ID |
Unique identifier that represents a file. |
Text |
|
File Description |
Description of this file. |
Text |
|
Version ID |
Unique identifier that represents the file version. |
Text |
|
ETag |
HTTP ETag of this file. This can be used within some API endpoints in the If-Match and If-None-Match headers to only perform changes on the file if (no) changes have happened. |
Text |
|
Sequence ID |
Numeric identifier that represents the most recent user event that has been applied to this item. |
Text |
|
Size |
Size of the file in bytes. |
Text |
|
Path |
Path starting at the root. |
Text |
|
Time Created |
Date and time when the file was created in Box. |
Date & Time |
|
Time Modified |
Date and time when the file was last modified in Box. |
Date & Time |
|
Time Content Created |
Date and time at which this file was originally created, which might be before it was uploaded to Box. |
Date & Time |
|
Time Content Modified |
Date and time at which this file was last updated, which might be before it was uploaded to Box. |
Date & Time |
|
Parent Folder Name |
Unique identifier that represent a parent name. |
Text |
|
Parent Folder ID |
Unique identifier that represent a parent folder. |
Text |
|
Item Status |
Defines if this item has been deleted. |
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 |
|
Password Enabled |
True if the shared link requires a password to access the item; otherwise, False. |
True/False |
|
Time Unshared |
Date and time when the 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. For example, Edit or View. |
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 |
|
Created By |
||
|
Name |
Name of user who created the file. |
Text |
|
User ID |
Unique identifier of the user who last created the file. |
Text |
|
|
Email address of the user who created the file. |
Text |
|
Modified By |
||
|
Name |
Name of user who modified the file. |
Text |
|
User ID |
Unique identifier of the user who last modified the file. |
Text |
|
|
Email address of the user who modified the file. |
Text |
|
Owned By |
||
|
Name |
Name of the user who owns the file. |
Text |
|
User ID |
Unique identifier of the user who last owns the file. |
Text |
|
|
Email address of the user who owns the file. |
Text |
|
Additional Info |
||
|
Additional Info |
Additional information which Box can return. |
Object |
|
Context |
||
|
Execution ID |
Execution identifier of the Webhook event. |
Text |
Additional information
Information about uploaded folders is not returned.
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.