The Slack developer docs are moving! We've been working hard at building out a new docs experience at docs.slack.dev — now in beta! You can start using the new docs today, but we'll keep the content on both sites up to date during the transition.

Reference: Shortcuts payloads

Received when a user uses any shortcut created by the receiving app.

Read our guide to handling payloads from user interactions to learn how your app should process and respond to these payloads.

Fields

This is a non-exhaustive list of fields that can be encountered in this type of interaction payload:

Field	Description
`type`	Helps identify which type of interactive component sent the payload. Global shortcuts will return `shortcut`, message shortcuts will return `message_action`.
`callback_id`	An ID that you defined when creating the shortcut.
`trigger_id`	A temporary ID generated for the interaction in your app. This value can be used to open modals.
`response_url`	A temporary webhook that can be used to send messages in response to interactions. This field will only be included for message shortcuts. If you want to send messages in response to global shortcuts, read this guide.
`user`	The user who initiated the shortcut.
`message`	The message that the user initiated the shortcut from. This field will only be included for message shortcuts. This will include the full structure of the message.
`channel`	The channel that the source `message` was located in. This field will only be included for message shortcuts.
`team`	The workspace (what we used to call a `team`) that the shortcut was initiated in.
`token`	A deprecated verification token feature. You should validate the request payload, however, and the best way to do so is to use the signing secret provided to your app.

Examples

A payload received when a global shortcut is used:

{
  "type": "shortcut",
  "token": "XXXXXXXXXXXXX",
  "action_ts": "1581106241.371594",
  "team": {
    "id": "TXXXXXXXX",
    "domain": "shortcuts-test"
  },
  "user": {
    "id": "UXXXXXXXXX",
    "username": "aman",
    "team_id": "TXXXXXXXX"
  },
  "callback_id": "shortcut_create_task",
  "trigger_id": "944799105734.773906753841.38b5894552bdd4a780554ee59d1f3638"
}

A payload received when a message shortcut is used in a message context menu:

{
  "token": "Nj2rfC2hU8mAfgaJLemZgO7H",
  "callback_id": "chirp_message",
  "type": "message_action",
  "trigger_id": "13345224609.8534564800.6f8ab1f53e13d0cd15f96106292d5536",
  "response_url": "https://hooks.slack.com/app-actions/T0MJR11A4/21974584944/yk1S9ndf35Q1flupVG5JbpM6",
  "team": {
    "id": "T0MJRM1A7",
    "domain": "pandamonium",
  },
  "channel": {
    "id": "D0LFFBKLZ",
    "name": "cats"
  },
  "user": {
    "id": "U0D15K92L",
    "name": "dr_maomao"
  },
  "message": {
    "type": "message",
    "user": "U0MJRG1AL",
    "ts": "1516229207.000133",
    "text": "World's smallest big cat! <https://youtube.com/watch?v=W86cTIoMv2U>"
  }
}

Make your next big announcement beautiful.

Block Kit Builder will show you how to compose your JSON just so.