Go to Slack

link_shared event

Compatibility: Events API

Events API Scope: links:read


A message was posted containing one or more links relevant to your application

Slack sends this event over the Events API for Slack apps set up to track a specific URL domain. While it's structured much like other events, it is unique in that there's a suggested usage pattern to follow when receiving them.

For context on these events, learn more about unfurling links in messages.

{
        "token": "XXYYZZ",
        "team_id": "TXXXXXXXX",
        "api_app_id": "AXXXXXXXXX",
        "event": {
            "type": "link_shared",
            "channel": "Cxxxxxx",
            "user": "Uxxxxxxx",
            "message_ts": "123456789.9875",
            "links":
                [
                    {
                        "domain": "example.com",
                        "url": "https://example.com/12345"
                    },
                    {
                        "domain": "example.com",
                        "url": "https://example.com/67890"
                    },
                    {
                        "domain": "another-example.com",
                        "url": "https://yet.another-example.com/v/abcde"
                    }
                ]
        },
        "type": "event_callback",
        "authed_users": [
                "UXXXXXXX1",
                "UXXXXXXX2"
        ],
        "event_id": "Ev08MFMKH6",
        "event_time": 123456789
}

Learn more about unfurling links in messages.

Events API compatibility

Subscribe to this event via the Events API.

Events of this type will be wrapped in metadata when sent via the Events API.

link_shared requires the links:read OAuth permission scope.

Unavailable in the RTM API

This event type is compatible only with the Events API.