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.

The link_shared event is not dispatched when a message posted by an app or integration includes a matching domain.

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",
        "is_bot_user_member": true,
        "user": "Uxxxxxxx",
        "message_ts": "123456789.9875",
        "thread_ts": "123456621.1855",
        "links": [
                "domain": "",
                "url": ""
                "domain": "",
                "url": ""
                "domain": "",
                "url": ""
    "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.

is_bot_user_member is a boolean field indicating whether the app’s bot user is a member of the conversation.

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.

Was this page helpful?