Skip to content
TriggerSlackReal-timeUpdated May 2026

How do I trigger when a file is shared in Slack?

Short answer: Drop the "SlackFile Shared" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Slack, 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 Shared
When the matching event happens
on file sharedwatch for file sharedwhen a file is shared in slackwhen file sharednew file shared
What this trigger returns
for the curious

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

{
"raw": {
"type": "event_callback",
"event": {
"type": "file_shared",
"file_id": "F0123ABC",
"user_id": "U0123DEF",
"event_ts": "1712835600.000100",
"channel_id": "C0123ABC"
},
"token": "verification_token",
"team_id": "T1234567890",
"event_id": "Ev1234567890",
"api_app_id": "A1234567890",
"event_time": 1712835600
},
"user": "U0123DEF",
"channel": "C0123ABC",
"file_id": "F0123ABC"
}
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.

FieldTypeExample
rawobject{ … }
raw.typestring"event_callback"
raw.eventobject{ … }
raw.event.typestring"file_shared"
raw.event.file_idstring"F0123ABC"
raw.event.user_idstring"U0123DEF"
raw.event.event_tsstring"1712835600.000100"
raw.event.channel_idstring"C0123ABC"
raw.tokenstring"verification_token"
userstring"U0123DEF"
channelstring"C0123ABC"
file_idstring"F0123ABC"
FAQ

Questions about File Shared.

How does the File Shared trigger work in Slack?
Fires when a file is shared in Slack. Use to mirror files to S3/Drive for backup, virus-scan, or to OCR receipts.
Is the File Shared trigger real-time?
Yes. File Shared uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Slack.
What data does File Shared return?
The full event payload from Slack. 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 Shared 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 Slack admin permissions to use File Shared?
For most Slack accounts a standard user can authorize the trigger. Some Slack plans require an admin to enable third-party webhooks. Check Slack's docs if the trigger fails to register.
More triggers

Other Slack triggers.

Build a workflow on this trigger.

One trigger. 45+ downstream actions. Zero glue.