View 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 * View interaction payloads Copy as markdown On this page View interaction payloads There are different types of payloads that can be received when users interact with modal views : * view_submission * view_closed view_submission payloads ​ Sent to an app's configured Request URL when a user submits a view in a modal . Read our guide to using modals to learn how your app should process and respond to these payloads. If you're using our Bolt framework, we have additional guidance on how to utilize the view_submission payload: * Bolt JS * Bolt Python * Bolt Java Properties ​ This is a list of some properties that can be encountered in this type of interaction payload: Properties received in a view_submission event may differ based on the source of the interactive elements. A check in the column means that property is included in a view_submission event sent to a function, a non-function, or both. Functions refer to apps created with the Deno Slack SDK . Property Functions Non-Functions Description Required? type ✓ ✓ Identifies the source of the payload. The type for this interaction is view_submission . Required team ✓ ✓ The workspace where the view was submitted from. Null if the app is org-installed. Required user ✓ ✓ The user who interacted to trigger this request. Required view ✓ ✓ The source view of the modal the user submitted. Required enterprise ✓ ✓ The enterprise that the installed app is a part of, if the app is either workspace-installed on an org, or org-installed. Required api_app_id ✓ ✓ A string representing the app ID. Required function_data ✓ Metadata about the function execution that generated the view where this view submission took place. Required interactivity ✓ An interactivity object generated as a result of the view submission. Required bot_access_token ✓ A workflow (just-in-time) token generated for this view submission. Required view.state.values ✓ ✓ A dictionary of objects. Each object represents a block in the source view that contained stateful, interactive components . Objects are keyed by the block_id of those blocks. These objects each contain a child object. The child object is keyed by the action_id of the interactive element in the block. This final child object will contain the type and submitted value of the input block element. Optional hash ✓ ✓ A unique value that is optionally accepted in views.update and views.publish API calls. When provided to those APIs, the hash is validated such that only the most recent view can be updated. This should be used to ensure the correct view is being updated when updates are happening asynchronously. Optional response_urls ✓ (Deprecated for apps created with the Deno Slack SDK) An array of objects that contain response_url values, used to send message responses . Each object will also contain block_id and action_id values to identify the source of the interaction. Also included is a channel_id which identifies where the response_url will publish to. response_urls is available only when the view contained block elements configured to generate a response_url . Optional Example ​ This is an example view_submission payload: { "type" : "view_submission" , "team" : { "id" : "T1234567" , "domain" : "example-domain" } , "user" : { "id" : "U1234567" , "username" : "example-user" } , "view" : { "id" : "VNHU13V36" , "type" : "modal" , "title" : { "type" : "plain_text" , "text" : "Modal Title" } , "submit" : { "type" : "plain_text" , "text" : "Submit" } , "blocks" : [ ] , "private_metadata" : "shhh-its-secret" , "callback_id" : "modal-with-inputs" , "state" : { "values" : { "multiline" : { "mlvalue" : { "type" : "plain_text_input" , "value" : "This is my example inputted value" } } , "target_channel" : { "target_select" : { "type" : "conversations_select" , "selected_conversation" : "C123B12DE" } } } } , "hash" : "156663117.cd33ad1f" , "response_urls" : [ { "block_id" : "target_channel" , "action_id" : "target_select" , "channel_id" : "C123B12DE" , "response_url" : "https://hooks.slack.com/app/ABC12312/1234567890/A100B100C100d100" } ] } } This was generated from the submission of this example view: { "view" : { "type" : "modal" , "callback_id" : "modal-with-inputs" , "title" : { "type" : "plain_text" , "text" : "Modal with inputs" } , "blocks" : [ { "type" : "input" , "block_id" : "multiline" , "label" : { "type" : "plain_text" , "text" : "Enter your value" } , "element" : { "type" : "plain_text_input" , "multiline" : true , "action_id" : "mlvalue" } } , { "block_id" : "target_channel" , "type" : "input" , "optional" : true , "label" : { "type" : "plain_text" , "text" : "Select a channel to post the result on" } , "element" : { "action_id" : "target_select" , "type" : "conversations_select" , "response_url_enabled" : true } } ] , "submit" : { "type" : "plain_text" , "text" : "Submit" } } } view_closed payloads ​ Optionally sent to an app's configured Request URL when a user dismisses a modal . To receive these payloads, the modal view must have been created with the notify_on_close argument set to true . Read our guide to using modals to learn how your app should process and respond to these payloads. Fields ​ Field Description type Helps identify the source of the payload. The type for this interaction is view_closed . team The workspace that the interaction happened in. user The user who dismissed a modal to trigger this request. view The source modal view that the user dismissed. This will include the full state of the view, excluding any input blocks in the modal. is_cleared A boolean that represents whether or not a whole view stack was cleared. Example ​ { "type" : "view_closed" , "team" : { "id" : "TXXXXXX" , "domain" : "coverbands" } , "user" : { "id" : "UXXXXXX" , "name" : "dreamweaver" } , "view" : { "id" : "VXXXXXX" , "type" : "modal" , "title" : { "type" : "plain_text" , "text" : "Modal Title" } , "blocks" : [ ] } , "api_app_id" : "AXXXXXX" , "is_cleared" : false } Previous Shortcuts interaction payloads Next Overview Copy as markdown * view_submission payloads * Properties * Example * view_closed payloads * Fields * Example . * 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. * * *