<!DOCTYPE html><html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-authentication/authentication" data-has-hydrated="false" data-theme="light" data-theme-choice="light"><head><meta charset="UTF-8"><meta name="generator" content="Docusaurus v3.10.2"><title data-rh="true">Authentication overview | Slack Developer Docs</title><meta data-rh="true" name="viewport" content="width=device-width, initial-scale=1.0"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.slack.dev/authentication/"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Authentication overview | Slack Developer Docs"><meta data-rh="true" name="description" content="Authentication is a critical part of the development process, but it doesn’t have to be daunting. With the right tools and best practices, you’ll have a secure, smooth authentication flow. Whether you’re handling OAuth 2.0, verifying requests, or setting up Sign in with Slack, we’ve got you covered."><meta data-rh="true" property="og:description" content="Authentication is a critical part of the development process, but it doesn’t have to be daunting. With the right tools and best practices, you’ll have a secure, smooth authentication flow. Whether you’re handling OAuth 2.0, verifying requests, or setting up Sign in with Slack, we’ve got you covered."><link data-rh="true" rel="icon" href="/img/logos/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.slack.dev/authentication/"><link data-rh="true" rel="alternate" href="https://docs.slack.dev/authentication/" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.slack.dev/authentication/" hreflang="x-default"><script async="" src="https://www.googletagmanager.com/gtm.js?id=GTM-TVQFL84W"></script><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://docs.slack.dev/authentication/","name":"Authentication","position":1}]}</script><link rel="alternate" type="application/rss+xml" href="/changelog/rss.xml" title="Slack Developer Docs RSS Feed"><link rel="alternate" type="application/atom+xml" href="/changelog/atom.xml" title="Slack Developer Docs Atom Feed"><script>function gtag(){dataLayer.push(arguments)}function OptanonWrapper(){var a=OptanonActiveGroups.includes(",2,");gtag("consent","update",{analytics_storage:a?"granted":"denied"}),dataLayer.push({event:"OneTrustGroupsUpdated",OnetrustActiveGroups:OptanonActiveGroups,analyticsConsent:a?"granted":"denied"})}window.dataLayer=window.dataLayer||[],gtag("consent","default",{analytics_storage:"denied"})</script><link rel="preconnect" href="https://www.googletagmanager.com"><script>window.dataLayer=window.dataLayer||[],function(e,t,a,n,r){e[n]=e[n]||[],e[n].push({"gtm.start":new Date().getTime(),event:"gtm.js"});var d=t.getElementsByTagName(a)[0],g=t.createElement(a);g.async=!0,g.src="https://www.googletagmanager.com/gtm.js?id="+r+("dataLayer"!=n?"&l="+n:""),d.parentNode.insertBefore(g,d)}(window,document,"script","dataLayer","GTM-TVQFL84W")</script><meta name="google-site-verification" content="d1jXBEojz0KFbjvsojJJ77KWTOf_8sIb3T32nAQY0ak"><link rel="alternate" type="text/plain" title="llms.txt" href="/llms.txt"><script src="https://d34u8crftukxnk.cloudfront.net/onetrust/slack.dev/production/scripttemplates/otSDKStub.js" type="text/javascript" charset="UTF-8" data-domain-script="0198614a-ba8b-77a9-8d49-cfaf177eabd7"></script><link rel="stylesheet" href="/assets/css/styles.0f5fa513.css"><script src="/assets/js/runtime~main.d157c2e0.js" defer=""></script><script src="/assets/js/main.fb9f77ce.js" defer=""></script></head><body><svg style="display: none;"><defs>
<symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></symbol>
</defs></svg>
<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||"light"),document.documentElement.setAttribute("data-theme-choice",t||"light")}(),function(){try{for(var[t,e]of new URLSearchParams(window.location.search).entries())if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script>

<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-TVQFL84W" height=0 width=0 style=display:none;visibility:hidden></iframe></noscript><div id="__docusaurus"><link rel="preload" as="image" href="/img/logos/logo-light.svg"><link rel="preload" as="image" href="/img/logos/logo-dark.svg"><div style="display:none" aria-hidden="true"><div data-pagefind-filter="content_type">guide</div></div><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" target="_self" href="/"><div class="navbar__logo"><img src="/img/logos/logo-light.svg" alt="Slack Developer Docs" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/img/logos/logo-dark.svg" alt="Slack Developer Docs" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div></a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" target="_self" href="/">Guides</a><a class="navbar__item navbar__link" target="_self" href="/reference">Reference</a><a class="navbar__item navbar__link" target="_self" href="/samples">Samples</a><a class="navbar__item navbar__link" target="_self" href="/tools">Tools</a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a class="navbar__item navbar__link" target="_self" href="/changelog">Changelog</a><a href="https://api.slack.com/developer-program" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Dev Program</a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP systemToggleIcon_QzmC"><path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbar__search-wrapper"><div class="navbar__search"><div style="position:relative;padding:0 0.5rem"><div style="position:relative;display:inline-block"><input type="text" placeholder="Search docs" class="pagefind-custom-input pagefind-navbar-input" value=""></div></div></div><a href="https://api.slack.com/apps" target="_blank" rel="noopener noreferrer" class="navbar-manage-apps-button outlined-button manage-apps-link">MANAGE APPS</a></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_z2l0"><div class="docsWrapper_hBAB"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docRoot_UBD9"><aside class="theme-doc-sidebar-container docSidebarContainer_YfHR"><div class="sidebarViewport_aRkj"><div class="sidebar_njMd"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/"><span class="linkLabel_WmDU">Welcome!</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/quickstart"><span class="linkLabel_WmDU">Quickstart</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/developer-support"><span class="categoryLinkLabel_W154">Resources</span></a><button aria-label="Expand sidebar category 'Resources'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1"><hr></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/concepts/overview"><span class="categoryLinkLabel_W154">Slack platform concepts</span></a><button aria-label="Expand sidebar category 'Slack platform concepts'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/ai/"><span class="categoryLinkLabel_W154">AI in Slack</span></a><button aria-label="Expand sidebar category 'AI in Slack'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/apis/"><span class="categoryLinkLabel_W154">APIs</span></a><button aria-label="Expand sidebar category 'APIs'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/app-management/"><span class="categoryLinkLabel_W154">App management</span></a><button aria-label="Expand sidebar category 'App management'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/app-manifests/"><span class="categoryLinkLabel_W154">App manifests</span></a><button aria-label="Expand sidebar category 'App manifests'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/admins/"><span class="categoryLinkLabel_W154">Admin resources</span></a><button aria-label="Expand sidebar category 'Admin resources'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible menu__list-item-collapsible--active"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--active" aria-current="page" href="/authentication/"><span class="categoryLinkLabel_W154">Authentication</span></a><button aria-label="Collapse sidebar category 'Authentication'" aria-expanded="true" type="button" class="clean-btn menu__caret"></button></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/authentication/"><span class="linkLabel_WmDU">Overview</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/authentication/tokens"><span class="linkLabel_WmDU">Tokens</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/authentication/installing-with-oauth"><span class="linkLabel_WmDU">Installing with OAuth</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/authentication/using-token-rotation"><span class="linkLabel_WmDU">Using token rotation</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/authentication/using-pkce"><span class="linkLabel_WmDU">Using PKCE</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/authentication/verifying-requests-from-slack"><span class="linkLabel_WmDU">Verifying requests from Slack</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/authentication/authorizing-with-postman"><span class="linkLabel_WmDU">Authorizing with Postman</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/authentication/binding-accounts-across-services"><span class="linkLabel_WmDU">Binding accounts across services</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" tabindex="0" href="/authentication/sign-in-with-slack/"><span class="categoryLinkLabel_W154">Sign in with Slack</span></a><button aria-label="Expand sidebar category 'Sign in with Slack'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/block-kit/"><span class="categoryLinkLabel_W154">Block Kit</span></a><button aria-label="Expand sidebar category 'Block Kit'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/enterprise/"><span class="categoryLinkLabel_W154">Enterprise</span></a><button aria-label="Expand sidebar category 'Enterprise'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/enterprise-search/"><span class="categoryLinkLabel_W154">Enterprise Search for apps</span></a><button aria-label="Expand sidebar category 'Enterprise Search for apps'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/govslack"><span class="linkLabel_WmDU">GovSlack</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/interactivity/"><span class="categoryLinkLabel_W154">Interactivity</span></a><button aria-label="Expand sidebar category 'Interactivity'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/messaging/"><span class="categoryLinkLabel_W154">Messaging</span></a><button aria-label="Expand sidebar category 'Messaging'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/slack-marketplace/"><span class="categoryLinkLabel_W154">Slack Marketplace</span></a><button aria-label="Expand sidebar category 'Slack Marketplace'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/surfaces/"><span class="categoryLinkLabel_W154">Surfaces</span></a><button aria-label="Expand sidebar category 'Surfaces'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/workflows/"><span class="categoryLinkLabel_W154">Workflows</span></a><button aria-label="Expand sidebar category 'Workflows'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1"><hr></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/legacy/"><span class="categoryLinkLabel_W154">Legacy</span></a><button aria-label="Expand sidebar category 'Legacy'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1"><hr></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist" href="/ja-jp/"><span class="categoryLinkLabel_W154">日本語版ページ</span></a><button aria-label="Expand sidebar category '日本語版ページ'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li></ul></nav><button type="button" title="Collapse sidebar" aria-label="Collapse sidebar" class="button button--secondary button--outline collapseSidebarButton_PEFL"><svg width="20" height="20" aria-hidden="true" class="collapseSidebarButtonIcon_kv0_"><g fill="#7a7a7a"><path d="M9.992 10.023c0 .2-.062.399-.172.547l-4.996 7.492a.982.982 0 01-.828.454H1c-.55 0-1-.453-1-1 0-.2.059-.403.168-.551l4.629-6.942L.168 3.078A.939.939 0 010 2.528c0-.548.45-.997 1-.997h2.996c.352 0 .649.18.828.45L9.82 9.472c.11.148.172.347.172.55zm0 0"></path><path d="M19.98 10.023c0 .2-.058.399-.168.547l-4.996 7.492a.987.987 0 01-.828.454h-3c-.547 0-.996-.453-.996-1 0-.2.059-.403.168-.551l4.625-6.942-4.625-6.945a.939.939 0 01-.168-.55 1 1 0 01.996-.997h3c.348 0 .649.18.828.45l4.996 7.492c.11.148.168.347.168.55zm0 0"></path></g></svg></button></div></div></aside><main class="docMainContainer_TBSr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_TYmE" aria-label="Breadcrumbs"><ul class="breadcrumbs"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_YNFT"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link">Authentication</span></li></ul></nav><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Authentication overview</h1></header>
<p>Authentication is a critical part of the development process, but it doesn’t have to be daunting. With the right tools and best practices, you’ll have a secure, smooth authentication flow. Whether you’re handling <a class="" href="/authentication/installing-with-oauth">OAuth 2.0</a>, <a class="" href="/authentication/verifying-requests-from-slack">verifying requests</a>, or setting up <a class="" href="/authentication/sign-in-with-slack/">Sign in with Slack</a>, we’ve got you covered.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="basics">Authentication basics<a href="#basics" class="hash-link" aria-label="Direct link to Authentication basics" title="Direct link to Authentication basics" translate="no">​</a></h2>
<p>Before your app can access Slack data or interact with Slack workspaces, it must go through an authentication process. This involves obtaining the necessary tokens and permissions for your app to function properly. Slack apps use OAuth <a class="" href="/reference/scopes">scopes</a> to govern what they can access. These are added in the app settings when building an app. You will attach these scopes to your tokens. Check out <a class="" href="/authentication/tokens">tokens</a> to learn more. You can rotate those tokens too! Find out how on the <a class="" href="/authentication/using-token-rotation">Using token rotation</a> page.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="concepts">Key concepts<a href="#concepts" class="hash-link" aria-label="Direct link to Key concepts" title="Direct link to Key concepts" translate="no">​</a></h2>
<ul>
<li class=""><a class="" href="/authentication/installing-with-oauth"><strong>OAuth 2.0</strong></a>: Learn how to use OAuth 2.0 to securely authenticate users and request access tokens.</li>
<li class=""><a class="" href="/authentication/tokens"><strong>Tokens</strong></a>: Understand the different types of tokens your app can use (user tokens, bot tokens, and app tokens) and how to manage them, as well as employ token rotation and expiry to keep things fresh.</li>
<li class=""><a class="" href="/concepts/security"><strong>Security best practices</strong></a>: Learn about security practices for managing authentication, such as validating tokens, handling sensitive data, and protecting your app from unauthorized access.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="reference">Reference<a href="#reference" class="hash-link" aria-label="Direct link to Reference" title="Direct link to Reference" translate="no">​</a></h2>
<ul>
<li class=""><a class="" href="/reference/scopes"><strong>Scopes and Permissions</strong></a>: Find the right permissions for your app to ensure access is limited to only the necessary data.</li>
</ul></div></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/admins/scim-api"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Using the Slack SCIM API</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/authentication/"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Overview</div></a></nav></div></div><div class="col col--3"><div class="toc-wrapper-custom"><div class="toc-copy-container"><div class="copy-button-container" style="display:flex;justify-content:flex-start;margin-bottom:1rem"><div class="copy-btn-group"><button type="button" class="minimal-text-btn copy-btn-main ">Copy as markdown</button><button type="button" class="minimal-text-btn copy-btn-arrow" aria-label="More options"><svg width="10" height="6" viewBox="0 0 10 6" fill="none" aria-hidden="true"><path d="M1 1L5 5L9 1" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path></svg></button></div></div></div><div class="toc-scroll-area"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#basics" class="table-of-contents__link toc-highlight">Authentication basics</a></li><li><a href="#concepts" class="table-of-contents__link toc-highlight">Key concepts</a></li><li><a href="#reference" class="table-of-contents__link toc-highlight">Reference</a></li></ul></div></div></div></div></div></div></main></div></div></div><footer class="theme-layout-footer footer"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class="footer__title">.</div><ul class="footer__items clean-list"><li class="footer__item">
                    <a href="/" class="c-slackhash desktop" aria-label="Slack"><svg width="54" viewBox="0 0 170 170" fill="none" xmlns="http://www.w3.org/2000/svg"><circle cx="85" cy="85" r="85" fill="#181818"></circle><path d="M170 85C170 38.0558 131.944 0 85 0V85H170Z" fill="#41B658"></path><path d="M85 170C131.944 170 170 131.944 170 85L85 85L85 170Z" fill="#FCC003"></path><path d="M0 85C0 131.944 38.0558 170 85 170L85 85L0 85Z" fill="#E3066A"></path><path d="M85 0C38.0558 0 0 38.0558 0 85L85 85L85 0Z" fill="#1AB9FF"></path><circle cx="84.9999" cy="84.9999" r="77.8505" fill="white"></circle><path d="M136.881 111.624V116.652H108.146V111.624H136.881Z" fill="black"></path><path d="M95.239 116.919H91.1738L82.418 94.7607H88.0467L93.2846 109.61H93.4018L98.327 94.7607H104.034L95.239 116.919Z" fill="black"></path><path d="M80.6335 107.933H63.7863C64.1772 109.848 66.5616 112.389 69.7669 112.389C71.9167 112.389 73.7148 111.529 74.7702 109.614H80.2426C78.8354 113.992 74.3793 117.158 69.7669 117.158C63.2391 117.158 58.314 112.076 58.314 105.666C58.314 99.2554 63.1218 94.0176 69.7278 94.0176C76.021 94.0176 80.9462 98.9818 80.9462 105.314C80.9462 106.135 80.8289 106.995 80.6335 107.933ZM63.63 103.751H75.6301C75.122 100.624 72.9721 98.7864 69.7278 98.7864C66.8743 98.7864 64.4508 100.428 63.63 103.751Z" fill="black"></path><path d="M38.9577 116.92H32V87.9941H38.9187C43.8438 87.9941 48.6126 89.0886 51.4269 92.2939C54.7886 96.0854 55.2185 100.542 55.2185 102.183C55.2185 106.6 53.6941 110.079 51.466 112.503C48.6517 115.551 45.1337 116.92 38.9577 116.92ZM37.3551 111.916H39.075C42.9057 111.916 45.6809 110.9 47.4008 109.063C49.2771 107.069 49.8634 104.45 49.8634 102.535C49.8634 100.151 49.0035 97.8053 47.3227 95.9682C45.5637 94.0528 42.8666 92.9975 38.9187 92.9975H37.3551V111.916Z" fill="black"></path><path d="M137 82.1982H130.433L122.725 71.3487H122.647V82.1982H117.448L117.449 52H122.647L122.647 70.0197H122.725L129.644 59.8177H135.625L127.807 70.4497L137 82.1982Z" fill="black"></path><path d="M107.104 74.4369H112.967C111.13 79.4012 107.065 82.2155 102.101 82.2155C95.6902 82.2155 90.5696 76.9386 90.5696 70.5672C90.5696 64.313 95.6902 59.0752 102.062 59.0752C106.948 59.0752 111.286 62.0068 112.967 67.0101H107.104C105.97 64.9775 104.446 63.844 102.062 63.844C98.3873 63.844 95.7683 66.7756 95.7683 70.6454C95.7683 74.5151 98.5827 77.4467 102.296 77.4467C104.446 77.4467 106.01 76.1959 107.104 74.4369Z" fill="black"></path><path d="M86.3326 81.5119H81.5638V78.8148C79.8439 80.8474 76.6386 82.2155 73.9415 82.2155C67.8438 82.2155 63.4268 77.0949 63.4268 70.5281C63.4268 64.2349 68.0001 59.0752 74.2933 59.0752C77.3422 59.0752 80.352 60.8733 81.4856 62.5541H81.5638V59.8179H86.3326V81.5119ZM75.0751 77.4467C78.8667 77.4467 81.4074 74.3197 81.4074 70.6063C81.4074 66.8147 78.7885 63.844 75.036 63.844C71.4008 63.844 68.6255 66.8929 68.6255 70.7626C68.6255 74.3978 71.4008 77.4467 75.0751 77.4467Z" fill="black"></path><path d="M59.816 82.1982H54.7056V52H59.816V82.1982Z" fill="black"></path><path d="M50.0979 60.2477H44.6256V60.2086C44.4692 58.3323 43.4138 57.0033 41.3812 57.0033C39.7004 57.0033 38.4105 58.2151 38.4105 59.9349C38.4105 61.8112 39.6613 62.9057 42.1239 63.6093C48.2217 65.4073 50.8015 68.1435 50.8015 72.8732C50.8015 78.541 46.6972 82.0981 41.4203 82.0981C36.3779 82.0981 32.3127 78.4629 32 73.225H37.6287C37.9024 75.6094 39.3095 77.0948 41.4594 77.0948C43.6483 77.0948 45.4464 75.4921 45.4464 73.4204C45.4464 71.3097 44.0392 70.0588 41.733 69.238C37.1597 67.5963 33.0554 66.3064 33.0554 60.2477C33.0554 55.3225 36.9642 52 41.5376 52C45.9937 52 49.8243 55.3616 50.0979 60.2477Z" fill="black"></path></svg></a>
                  </li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Tools</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/tools/slack-cli/">Slack CLI</a></li><li class="footer__item"><a class="footer__link-item" href="/tools/#bolt">Bolt frameworks</a></li><li class="footer__item"><a class="footer__link-item" href="/tools/#sdks">Slack SDKs</a></li><li class="footer__item"><a href="https://app.slack.com/block-kit-builder/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Block Kit Builder</a></li><li class="footer__item"><a href="https://api.slack.com/developer-program" target="_blank" rel="noopener noreferrer" class="footer__link-item">Developer program</a></li><li class="footer__item"><a class="footer__link-item" href="/samples/">Code samples &amp; tutorials</a></li><li class="footer__item"><a href="https://docs.slack.dev/llms.txt" target="_blank" rel="noopener noreferrer" class="footer__link-item">LLM? Read llms.txt</a></li><li class="footer__item"><a class="footer__link-item" href="/tools/">All tools</a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Learn</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://slack.dev/learning-paths/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Learning paths</a></li><li class="footer__item"><a href="https://slack.dev/workshops" target="_blank" rel="noopener noreferrer" class="footer__link-item">Workshops</a></li><li class="footer__item"><a href="https://trailheadacademy.salesforce.com/all-offerings#f-assetType=Certification&amp;f-products=Slack&amp;f-siteLanguage=en_US" target="_blank" rel="noopener noreferrer" class="footer__link-item">Slack certifications</a></li><li class="footer__item"><a href="https://trailhead.salesforce.com/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Trailhead</a></li><li class="footer__item"><a href="https://slack.dev/resource-library" target="_blank" rel="noopener noreferrer" class="footer__link-item">Resource library</a></li><li class="footer__item"><a href="https://slack.dev/learn" target="_blank" rel="noopener noreferrer" class="footer__link-item">All learning resources</a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://slack.dev/community" target="_blank" rel="noopener noreferrer" class="footer__link-item">Slack community</a></li><li class="footer__item"><a href="https://slack.dev/events" target="_blank" rel="noopener noreferrer" class="footer__link-item">Slack events</a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Resources</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/">Docs</a></li><li class="footer__item"><a href="https://slack.dev/blog" target="_blank" rel="noopener noreferrer" class="footer__link-item">Blog</a></li><li class="footer__item"><a href="https://slack.com/marketplace" target="_blank" rel="noopener noreferrer" class="footer__link-item">Slack marketplace</a></li><li class="footer__item"><a href="https://slack.dev/newsletter" target="_blank" rel="noopener noreferrer" class="footer__link-item">Developer newsletter</a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Manage Apps</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://api.slack.com/apps" target="_blank" rel="noopener noreferrer" class="footer__link-item">Your apps</a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright"><div class="footer__submenu">
          <div>
            <div class="legal-links">
              <ul class="legal_list" aria-label="Legal links">
                <li><a href="https://slack-status.com/" rel="noopener noreferrer" target="_blank">Status</a></li>
                <li><a href="https://slack.com/trust/privacy/privacy-policy">Privacy</a></li>
                <li><a href="https://slack.com/terms-of-service/api" target="_blank" rel="noopener noreferrer">Terms</a></li>
                <li><a class="optanon-show-settings" href="#" data-preference-center="">Cookie Preferences</a></li>
                <li><a href="https://docs.slack.dev/developer-support" rel="noopener noreferrer" target="_blank">Support</a></li>
                <li><a href="https://docs.slack.dev/changelog" rel="noopener noreferrer" target="_blank">Changelog</a></li>
                <li><a class="privacy-choice" href="https://www.salesforce.com/form/other/privacy-request/" aria-label="Your Privacy Choices" title="Your Privacy Choices" target="_blank" rel="noopener"><span>Your Privacy Choices</span><svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="30" height="14" style="enable-background:new 0 0 30 14"><path d="M7.4 12.8h6.8l3.1-11.6H7.4C4.2 1.2 1.6 3.8 1.6 7s2.6 5.8 5.8 5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#fff"></path><path d="M22.6 0H7.4c-3.9 0-7 3.1-7 7s3.1 7 7 7h15.2c3.9 0 7-3.1 7-7s-3.2-7-7-7zm-21 7c0-3.2 2.6-5.8 5.8-5.8h9.9l-3.1 11.6H7.4c-3.2 0-5.8-2.6-5.8-5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#06f"></path><path d="M24.6 4c.2.2.2.6 0 .8L22.5 7l2.2 2.2c.2.2.2.6 0 .8-.2.2-.6.2-.8 0l-2.2-2.2-2.2 2.2c-.2.2-.6.2-.8 0-.2-.2-.2-.6 0-.8L20.8 7l-2.2-2.2c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0l2.2 2.2L23.8 4c.2-.2.6-.2.8 0z" style="fill:#fff"></path><path d="M12.7 4.1c.2.2.3.6.1.8L8.6 9.8c-.1.1-.2.2-.3.2-.2.1-.5.1-.7-.1L5.4 7.7c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0L8 8.6l3.8-4.5c.2-.2.6-.2.9 0z" style="fill:#06f"></path></svg></a></li>
              </ul>
            </div>
            <small class="legal-text">© 2026 Slack Technologies, LLC, a Salesforce company. All rights reserved. Various trademarks held by their respective owners.</small>
          </div>
          <ul class="social_list">
            <li class="listitem-social">
              <a class="brand-linkedin" aria-label="LinkedIn" title="LinkedIn" target="_blank" rel="noopener" href="https://www.linkedin.com/company/tiny-spec-inc/">
                <svg width="18" height="18" version="1" viewBox="0 0 18 18" xmlns="http://www.w3.org/2000/svg" role="presentation"><path d="M1.84613 3.69226C2.86519 3.69226 3.69226 2.86519 3.69226 1.84613C3.69226 0.827067 2.86519 0 1.84613 0C0.827067 0 0 0.827067 0 1.84613C0 2.86519 0.827067 3.69226 1.84613 3.69226ZM0 16V4.92317H3.69226V16H0ZM6.15441 4.92317H9.55991V6.66838H9.60916C10.0829 5.81794 11.2423 4.92317 12.9716 4.92317C16.5666 4.92317 17.2312 7.16068 17.2312 10.0714V16H13.6804V10.7446C13.6804 9.49173 13.6546 7.87821 11.8343 7.87821C9.98578 7.87821 9.70267 9.24311 9.70267 10.6536V16H6.15441V4.92317Z"></path></svg>
              </a>
            </li>
            <li class="listitem-social">
              <a class="brand-bluesky" aria-label="Bluesky" title="Bluesky" target="_blank" rel="noopener" href="https://bsky.app/profile/slack.dev">
                <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 -3.268 64 68.414" height="18" role="presentation"><path d="M13.873 3.805C21.21 9.332 29.103 20.537 32 26.55v15.882c0-.338-.13.044-.41.867-1.512 4.456-7.418 21.847-20.923 7.944-7.111-7.32-3.819-14.64 9.125-16.85-7.405 1.264-15.73-.825-18.014-9.015C1.12 23.022 0 8.51 0 6.55 0-3.268 8.579-.182 13.873 3.805zm36.254 0C42.79 9.332 34.897 20.537 32 26.55v15.882c0-.338.13.044.41.867 1.512 4.456 7.418 21.847 20.923 7.944 7.111-7.32 3.819-14.64-9.125-16.85 7.405 1.264 15.73-.825 18.014-9.015C62.88 23.022 64 8.51 64 6.55c0-9.818-8.578-6.732-13.873-2.745z"></path></svg>
              </a>
            </li>
            <li class="listitem-social">
              <a class="brand-youtube" aria-label="YouTube" title="YouTube" target="_blank" rel="noopener" href="https://www.youtube.com/channel/UCY3YECgeBcLCzIrFLP4gblw">
                <svg width="18" height="18" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg" role="presentation"><path d="M29.41,9.26a3.5,3.5,0,0,0-2.47-2.47C24.76,6.2,16,6.2,16,6.2s-8.76,0-10.94.59A3.5,3.5,0,0,0,2.59,9.26,36.13,36.13,0,0,0,2,16a36.13,36.13,0,0,0,.59,6.74,3.5,3.5,0,0,0,2.47,2.47C7.24,25.8,16,25.8,16,25.8s8.76,0,10.94-.59a3.5,3.5,0,0,0,2.47-2.47A36.13,36.13,0,0,0,30,16,36.13,36.13,0,0,0,29.41,9.26ZM13.2,20.2V11.8L20.47,16Z"></path></svg>
              </a>
            </li>
          </ul>
        </div></div></div></div></footer></div></body></html>