<!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><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 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"/></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"/></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"/></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"/></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"/></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 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 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 class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1"><hr/><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 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 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 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 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 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 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 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 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 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 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 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 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 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 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></ul><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 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 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 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 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 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 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 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 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 class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1"><hr/><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 class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1"><hr/><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></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 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"/></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 /></svg></a><li class="breadcrumbs__item breadcrumbs__item--active"><span class=breadcrumbs__link>Authentication</span></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 /></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><a href=#concepts class="table-of-contents__link toc-highlight">Key concepts</a><li><a href=#reference class="table-of-contents__link toc-highlight">Reference</a></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 /><path d="M170 85C170 38.0558 131.944 0 85 0V85H170Z" fill=#41B658 /><path d="M85 170C131.944 170 170 131.944 170 85L85 85L85 170Z" fill=#FCC003 /><path d="M0 85C0 131.944 38.0558 170 85 170L85 85L0 85Z" fill=#E3066A /><path d="M85 0C38.0558 0 0 38.0558 0 85L85 85L85 0Z" fill=#1AB9FF /><circle cx=84.9999 cy=84.9999 r=77.8505 fill=white /><path d="M136.881 111.624V116.652H108.146V111.624H136.881Z" fill=black /><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 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 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 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 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 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 d="M59.816 82.1982H54.7056V52H59.816V82.1982Z" fill=black /><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 /></svg></a>
                  </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 class=footer__item><a class=footer__link-item href=/tools/#bolt>Bolt frameworks</a><li class=footer__item><a class=footer__link-item href=/tools/#sdks>Slack SDKs</a><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 class=footer__item><a href=https://api.slack.com/developer-program target=_blank rel="noopener noreferrer" class=footer__link-item>Developer program</a><li class=footer__item><a class=footer__link-item href=/samples/>Code samples & tutorials</a><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 class=footer__item><a class=footer__link-item href=/tools/>All tools</a></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 class=footer__item><a href=https://slack.dev/workshops target=_blank rel="noopener noreferrer" class=footer__link-item>Workshops</a><li class=footer__item><a href="https://trailheadacademy.salesforce.com/all-offerings#f-assetType=Certification&f-products=Slack&f-siteLanguage=en_US" target=_blank rel="noopener noreferrer" class=footer__link-item>Slack certifications</a><li class=footer__item><a href=https://trailhead.salesforce.com/ target=_blank rel="noopener noreferrer" class=footer__link-item>Trailhead</a><li class=footer__item><a href=https://slack.dev/resource-library target=_blank rel="noopener noreferrer" class=footer__link-item>Resource library</a><li class=footer__item><a href=https://slack.dev/learn target=_blank rel="noopener noreferrer" class=footer__link-item>All learning resources</a></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 class=footer__item><a href=https://slack.dev/events target=_blank rel="noopener noreferrer" class=footer__link-item>Slack events</a></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 class=footer__item><a href=https://slack.dev/blog target=_blank rel="noopener noreferrer" class=footer__link-item>Blog</a><li class=footer__item><a href=https://slack.com/marketplace target=_blank rel="noopener noreferrer" class=footer__link-item>Slack marketplace</a><li class=footer__item><a href=https://slack.dev/newsletter target=_blank rel="noopener noreferrer" class=footer__link-item>Developer newsletter</a></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></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 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 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 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 /></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"/></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"/></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 /></svg>
              </a>
            </li>
          </ul>
        </div></div></div></div></footer></div></body>