TriggerBoxReal-timeUpdated June 2026

When does Box fire on new file uploads?

Short answer: In TinyCommand, add the Box File Uploaded trigger to a workflow and publish. It listens through a Box webhook and fires your workflow within seconds of the event, with no polling and no code. Add a filter if you only want some events to start a run.

Use this trigger All 3 Box triggers

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder

Trigger

File Uploaded

When the matching event happens

on file uploadedwhen file uploadedwhen a file is uploaded to boxwatch for file uploadednew file uploaded

What this trigger returns

for the curious

You don’t need to read this. TinyCommand auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
  "name": "report.pdf",
  "size": 1024000,
  "file_id": "123456",
  "created_by": "user@example.com"
}

Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

Field	Type	Example
name	string	"report.pdf"
size	number	1024000
file_id	string	"123456"
created_by	string	"user@example.com"

Pairs with

Drop these actions after File Uploaded.

Add Labels to Message

Gmail · Email

Add Reaction

Slack · Communication

Add Sheet Tab

Google Sheets · Spreadsheets & Databases

Create Company

HubSpot · CRM & Sales

FAQ

Questions about File Uploaded.

How does the File Uploaded trigger work in Box?

Fires when a new file is uploaded to a watched folder. Payload includes filename, size, uploader, parent folder. The base hook for "auto-process new uploads" workflows — OCR receipts, scan for sensitive content, sync to a downstream system.

Is the File Uploaded trigger real-time?

Yes. File Uploaded uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Box.

What data does File Uploaded return?

The full event payload from Box. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.

Can I filter File Uploaded so only some events start a workflow?

Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.

Do I need Box admin permissions to use File Uploaded?

For most Box accounts a standard user can authorize the trigger. Some Box plans require an admin to enable third-party webhooks. Check Box's docs if the trigger fails to register.

More triggers

Other Box triggers.

Trigger

File Downloaded

Fires when a file is downloaded from Box. Useful for audit workflows that need to track "who downloaded which sensitive document when" or for engagement tracking on shared customer-facing content.

Trigger

Folder Created

Fires when a new folder is created inside a watched parent. Useful for "new client folder → auto-populate with intake checklist templates" provisioning workflows.