Docs
Docs and feature guides
Start learning
Authentication
Messaging
Metadata
Surfaces
Block Kit
Interactivity
APIs
Workflows
Enterprise
Apps for Admins
Reference
Docs and feature guides
Start learning
Overview
Intro to the Slack platform
Planning your app
Overview
Planning interaction
Choosing APIs
Communicating
Interaction guidelines
Designing a great experience
Overview
Designing home tabs
Designing modals
Shortcut guidelines
Choosing voice & tone
Localizing apps
Onboarding experiences
General guidelines
Building an app
Overview
Developing with JavaScript
Developing with Python
Developing with Java
Workflow Builder
Block Kit Builder
SDKs & tools
App blueprints
Distributing an app
Overview
Distributing apps publicly
Using the App Directory
App Directory Guidelines
Developer policies
Authentication
Overview
Installation & Permissions
Basic app setup
Installing with OAuth
Quickstart: what's new
Migration guide
Token rotation
Security
Verifying requests
Best practices
Access tokens
Token types
Configuration tokens
Reference
Scopes
Sign in with Slack
Messaging
Managing messages
Overview
Retrieving messages
Sending messages
Modifying messages
Scheduling messages
Using Webhooks
Composing messages
Overview
Formatting text
Message layouts
Interactive messages
Block Kit Builder
Working with files
Overview
Preparing your app for files
Uploading files to Slack
Adding remote files
Reference
Messages
Blocks
Secondary attachments
Link unfurling
Upgrading to blocks
Metadata
Overview
Guides
Publishing metadata
Using metadata
Metadata events
message_metadata_posted
message_metadata_updated
message_metadata_deleted
Event scope
Metadata schemas
Reference
Surfaces
Overview
Home tabs
Overview
Using your Home tab
Events in App Home
Modals
Overview
Using modals
Messages
Overview
Sending messages
Rich message layouts
Interactive messages
Reference
Defining views
Block Kit
Overview
Block basics
Building with Block Kit
Interactivity in Block Kit
Block Kit Builder
App templates
Reference
Overview
Blocks
Block elements
Interactive components
Composition objects
Defining views
block_actions payloads
View interaction payloads
Upgrading to modals
Interactivity
Overview
Handling user interaction
Entry points
Overview
Shortcuts
Slash Commands
Interactive components
Shortcuts
Overview
Implementing shortcuts
Interaction payloads
Overview
Shortcuts payloads
block_actions payloads
View interaction payloads
APIs
Overview
Connection protocols
Overview
Using the Events API over HTTP
Intro to Socket Mode
Socket Mode implementation
Usage guides
Using the Web API
Pagination
Rate limits
Slack Connect
Slack Connect APIs
Status API
Calls API
Presence & status
Bookmarks API
Reference
Methods
Event types
Object types
Workflows
Overview
Workflows for users
Introduction
Pre-built workflows
Workflows for developers
Webhook triggers
Steps from apps
Workflow Powerups
Reference
Configuration views
workflow_step
workflow_step_edit
workflow_step_execute
workflow_published
workflow_unpublished
workflow_deleted
workflow_step_deleted
Enterprise
Single-workspace apps
Overview
Preparing your app
Testing an Enterprise app
Organization-wide apps
Overview
Preparing for org-wide app deployment
OAuth & Installation for org-wide apps
Using APIs with org-wide apps
Migration
Reference
Apps for Admins
Overview
Managing channels
Managing app approvals
Managing users
Managing invite requests
Resetting sessions
Provisioning with SCIM
Audit Logs API
Reference
Translated content
🇯🇵
Stay updated
Changelog
Beta features
Developer blog
Roadmap
@SlackAPI
Resources
Our tools
Get support
Partner with us
API Terms of Service
Slack Fund
FAQ
Slack Engineering
Community
Community Discussion
Tools and resources
Groups and events
Code of Conduct
Hosting providers
Get Help
Tutorials
Tutorials
Post messages on a schedule
Responding to app mentions
Hello World Slack app using Bolt
How to quickly get and use a Slack API token
Posting messages using curl
Create an incident
Your apps
Sign in to Slack to manage apps
Start learning
Overview
Intro to the Slack platform
Planning your app
Overview
Planning interaction
Choosing APIs
Communicating
Interaction guidelines
Designing a great experience
Overview
Designing home tabs
Designing modals
Shortcut guidelines
Choosing voice & tone
Localizing apps
Onboarding experiences
General guidelines
Building an app
Overview
Developing with JavaScript
Developing with Python
Developing with Java
Workflow Builder
Block Kit Builder
SDKs & tools
App blueprints
Distributing an app
Overview
Distributing apps publicly
Using the App Directory
App Directory Guidelines
Developer policies
Authentication
Overview
Installation & Permissions
Basic app setup
Installing with OAuth
Quickstart: what's new
Migration guide
Token rotation
Security
Verifying requests
Best practices
Access tokens
Token types
Configuration tokens
Reference
Scopes
Sign in with Slack
Messaging
Managing messages
Overview
Retrieving messages
Sending messages
Modifying messages
Scheduling messages
Using Webhooks
Composing messages
Overview
Formatting text
Message layouts
Interactive messages
Block Kit Builder
Working with files
Overview
Preparing your app for files
Uploading files to Slack
Adding remote files
Reference
Messages
Blocks
Secondary attachments
Link unfurling
Upgrading to blocks
Metadata
Overview
Guides
Publishing metadata
Using metadata
Metadata events
message_metadata_posted
message_metadata_updated
message_metadata_deleted
Event scope
Metadata schemas
Reference
Surfaces
Overview
Home tabs
Overview
Using your Home tab
Events in App Home
Modals
Overview
Using modals
Messages
Overview
Sending messages
Rich message layouts
Interactive messages
Reference
Defining views
Block Kit
Overview
Block basics
Building with Block Kit
Interactivity in Block Kit
Block Kit Builder
App templates
Reference
Overview
Blocks
Block elements
Interactive components
Composition objects
Defining views
block_actions payloads
View interaction payloads
Upgrading to modals
Interactivity
Overview
Handling user interaction
Entry points
Overview
Shortcuts
Slash Commands
Interactive components
Shortcuts
Overview
Implementing shortcuts
Interaction payloads
Overview
Shortcuts payloads
block_actions payloads
View interaction payloads
APIs
Overview
Connection protocols
Overview
Using the Events API over HTTP
Intro to Socket Mode
Socket Mode implementation
Usage guides
Using the Web API
Pagination
Rate limits
Slack Connect
Slack Connect APIs
Status API
Calls API
Presence & status
Bookmarks API
Reference
Methods
Event types
Object types
Workflows
Overview
Workflows for users
Introduction
Pre-built workflows
Workflows for developers
Webhook triggers
Steps from apps
Workflow Powerups
Reference
Configuration views
workflow_step
workflow_step_edit
workflow_step_execute
workflow_published
workflow_unpublished
workflow_deleted
workflow_step_deleted
Enterprise
Single-workspace apps
Overview
Preparing your app
Testing an Enterprise app
Organization-wide apps
Overview
Preparing for org-wide app deployment
OAuth & Installation for org-wide apps
Using APIs with org-wide apps
Migration
Reference
Apps for Admins
Overview
Managing channels
Managing app approvals
Managing users
Managing invite requests
Resetting sessions
Provisioning with SCIM
Audit Logs API
Reference
Translated content
🇯🇵
Stay updated
Changelog
Beta features
Developer blog
Roadmap
@SlackAPI
Resources
Our tools
Get support
Partner with us
API Terms of Service
Slack Fund
FAQ
Slack Engineering
Community
Community Discussion
Tools and resources
Groups and events
Code of Conduct
Hosting providers
Get Help
View all scopes
users:read
View other scopes
View people in a workspace
Facts
Supported token types
User
Legacy bot
Deprecated workspace tokens
Bot
Compatible API methods
bots.info
users.getPresence
users.info
users.list
Compatible events
team_join
user_change
user_huddle_changed
user_profile_changed
user_status_changed
On this page
Facts