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

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

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

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.

Related topics

Box connector

Workflow elements

Box API documentation