Skip to main content

file_shared event

A file was shared

Facts

Required Scopes
Compatible APIs

Usage info​

This example includes both the event wrapper and the event structure for the file_shared event.

{
    "token": "XXYYZZ",
    "team_id": "T123ABC456",
    "api_app_id": "A123ABC456",
    "event": {
        "type": "file_shared",
        "channel_id": "D01315BHHSN",
        "file_id": "F2147483862",
        "user_id": "U0Z7K8SRH",
        "file": {
            "id": "F2147483862"
        },
        "event_ts": "1617804931.000300"
    },
    "type": "event_callback",
    "authed_users": [
        "U123ABC456",
        "U222222222"
    ],
    "event_id": "Ev123ABC456",
    "event_time": 123456789
}

The file_shared event is sent when a file is shared. It is sent to all connected clients for all users that have permission to see the file. The file property includes the file ID, as well as a top-level file_id. To obtain additional information about the file, use the files.info API method.