Docs and feature guides

Apps for Admins

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

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

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

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

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

View all scopes

users:write

View other scopes

Set presence for your slack app

Facts

Supported token types

UserLegacy botBot

Compatible API methods

users.setActiveusers.setPresence

On this page

Docs

Apps for Admins

Keep updated

Subscribe to our changelog to see the latest changes to the Slack platform.

Join our community

Connect with other developers, builders, designers, and product managers to build the future of work.