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. | String | TRUE |
Output
| Field | Definition | Type |
|---|---|---|
| Event | ||
| Event ID | Unique identifier of the event | String |
| Event Type |
Type of event that created this file.
For example, |
String |
| Event Time | Date and time when the event was triggered in Box. | Date and Time |
| Webhook ID | Unique identifier of the Webhook that triggered this event. | String |
| Event | Name of an event that triggered the event. | String |
| File | ||
| File Name | Name of the file. | String |
| File ID | Unique identifier that represents a file. | String |
| File Description | Description of this file. | String |
| Version ID | Unique identifier that represents the file version. | String |
| 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. | String |
| Sequence ID | Numeric identifier that represents the most recent user event that has been applied to this item. | String |
| Size | Size of the file in bytes. | String |
| Path | Path starting at the root. | String |
| Time Created | Date and time when the file was created in Box. | Date and Time |
| Time Modified | Date and time when the file was last modified in Box. | Date and Time |
| Time Content Created | Date and time at which this file was originally created, which might be before it was uploaded to Box. | Date and Time |
| Time Content Modified | Date and time at which this file was last updated, which might be before it was uploaded to Box. | Date and Time |
| Parent Folder Name | Unique identifier that represent a parent name. | String |
| Parent Folder ID | Unique identifier that represent a parent folder. | String |
| Item Status | Defines if this item has been deleted. | String |
| Shared Link | ||
| Share URL | URL that can be used to access the item on Box. | String |
| 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. | String |
| 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. | String |
| Password Enabled | True if the shared link requires a password to access the item; otherwise, False. |
Boolean |
| Time Unshared | Date and time when the link was unshared. | Date and 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, |
String |
| 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.
|
Boolean |
| 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. |
Boolean |
| Created By | ||
| Name | Name of user who created the file. | String |
| User ID | Unique identifier of the user who last created the file. | String |
| Email address of the user who created the file. | String | |
| Modified By | ||
| Name | Name of user who modified the file. | String |
| User ID | Unique identifier of the user who last modified the file. | String |
| Email address of the user who modified the file. | String | |
| Owned By | ||
| Name | Name of the user who owns the file. | String |
| User ID | Unique identifier of the user who last owns the file. | String |
| Email address of the user who owns the file. | String | |
| Additional Info | ||
| Additional Info | Additional information which Box can return. | Object |
| Context | ||
| Execution ID | Execution identifier of the Webhook event. | String |
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.