Documentation Tutorials Twitter

Success!

My Slack API

Documentation
Tutorials
Your 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

Security

Verifying requests
Best practices

Reference

Token types
Scopes
Sign in with Slack

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

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

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
Status API
Calls API
Presence & status

Reference

Methods
Event types
Object types

Workflows

Overview

Workflows for users

Introduction
Building workflows
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

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

Tools and resources
Groups and events
Code of Conduct
Hosting providers

identity.email scope

This scope lets an app View a user’s email address

Supported token types:

Browse all scopes

Was this page helpful?

Using Slack
Product
Enterprise
Pricing
Support
Slack Guides
App Directory
API

Slack
Jobs
Customers
Developers
Events
Blog

Legal
Privacy
Security
Terms of Service
Policies

Handy Links
Download desktop app
Download mobile app
Brand Guidelines
Slack at Work
Status

Contact Us