Shortcuts interaction payloads | Slack Developer Docs
https://docs.slack.dev/reference/interaction-payloads/shortcuts-interaction-payload/ • 50 KB fetched Open original page
Shortcuts interaction payloads | Slack Developer Docs
reference
Skip to main content
Guides Reference Samples Tools
Changelog Dev Program
MANAGE APPS
* Reference
* App manifest
* Block Kit
* Events
* Interaction payloads
* Overview
* block_actions payload
* block_suggestion payloads
* Shortcuts interaction payloads
* View interaction payloads
* Methods
* Objects
* Scopes
* Types
* Slack Connect API
* Views
*
* Audit Logs API
* Legal Holds API
* SCIM API
*
* Slack Status API
*
* Interaction payloads
* Shortcuts interaction payloads Copy as markdown
On this page
Shortcuts interaction 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>"
}
}
Previous
block_suggestion payloads
Next
View interaction payloads
Copy as markdown
* Fields
* Examples
.
*
Tools
* Slack CLI
* Bolt frameworks
* Slack SDKs
* Block Kit Builder
* Developer program
* Code samples & tutorials
* LLM? Read llms.txt
* All tools
Learn
* Learning paths
* Workshops
* Slack certifications
* Trailhead
* Resource library
* All learning resources
Community
* Slack community
* Slack events
Resources
* Docs
* Blog
* Slack marketplace
* Developer newsletter
Manage Apps
* Your apps
* Status
* Privacy
* Terms
* Cookie Preferences
* Support
* Changelog
* Your Privacy Choices
© 2026 Slack Technologies, LLC, a Salesforce company. All rights reserved. Various trademarks held by their respective owners.
*
*
*
Links found on this page
- Skip to main content [direct]
- Guides [direct]
- Reference [direct]
- Samples [direct]
- Tools [direct]
- Changelog [direct]
- Dev Program [direct]
- MANAGE APPS [direct]
- Reference [direct]
- App manifest [direct]
- Block Kit [direct]
- Events [direct]
- Interaction payloads [direct]
- block_actions payload [direct]
- block_suggestion payloads [direct]
- Shortcuts interaction payloads [direct]
- View interaction payloads [direct]
- Methods [direct]
- Objects [direct]
- Scopes [direct]
- Types [direct]
- Slack Connect API [direct]
- Views [direct]
- Audit Logs API [direct]
- Legal Holds API [direct]
- SCIM API [direct]
- Slack Status API [direct]
- shortcut created by the receiving app [direct]
- handling payloads from user interactions [direct]
- webhook [direct]
- read this guide [direct]
- message [direct]
- channel [direct]
- team [direct]
- use the signing secret provided to your app [direct]
- Slack CLI [direct]
- Bolt frameworks [direct]
- Block Kit Builder [direct]
- Code samples & tutorials [direct]
- LLM? Read llms.txt [direct]
- Learning paths [direct]
- Workshops [direct]
- Slack certifications [direct]
- Trailhead [direct]
- Resource library [direct]
- All learning resources [direct]
- Slack community [direct]
- Slack events [direct]
- Blog [direct]
- Slack marketplace [direct]
- Developer newsletter [direct]
- Status [direct]
- Privacy [direct]
- Terms [direct]
- Support [direct]
- Your Privacy Choices [direct]
|
|