Go to Slack

link_shared event

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

Compatibility: Events API

Expected scopes:

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",
        "thread_ts": "123456621.1855",
        "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": [
    "event_id": "Ev08MFMKH6",
    "event_time": 123456789

The thread_ts field only appears when the link was shared within a message thread.

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.

Unavailable in the RTM API

This event type is compatible only with the Events API.