TriggerBoxReal-timeUpdated May 2026
When does Box fire on file downloads?
Short answer: Drop the "Box → File Downloaded" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Box, not on a polling schedule.
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 Downloaded
When the matching event happens
new file downloadedon file downloadedwhen a file is downloaded from boxwhen file downloadedwatch for file downloaded
What this trigger returns
for the curiousYou don’t need to read this. Tiny Command 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","file_id": "123456","downloaded_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" |
| file_id | string | "123456" |
| downloaded_by | string | "user@example.com" |
Pairs with
Drop these actions after File Downloaded.
FAQ
Questions about File Downloaded.
How does the File Downloaded trigger work in Box?
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.
Is the File Downloaded trigger real-time?
Yes. File Downloaded uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Box.
What data does File Downloaded 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 Downloaded 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 Downloaded?
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 Uploaded
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.
TriggerFolder 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.
Build a workflow on this trigger.
One trigger. 6+ downstream actions. Zero glue.
