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, Webhook Event.

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, Edit or View.

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 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 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 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.

Related topics

Box connector

About the elements of Okta Workflows

Box API documentation