Enable domain-wide authentication for calendar and file apps in Slack

Who can use this feature?
  • Workspace Owners/Admins and Org Owners/Admins
  • Available on all plans

Workspace Owners and Workspace Admins on the Free, Pro, and Business+ plans, and Org Owners and Org Admins on Enterprise Grid can automatically connect all of their members' Slack accounts with the Google Calendar, Google Drive, Outlook Calendar, or OneDrive and SharePoint app. 

What to expect

  • Any owner or admin can start the domain-wide authentication process in Slack.
  • To authorize Slack access from Google Workspace or Office 365, you’ll need help from a Google Workspace Super Admin or Office 365 administrator. For OneDrive and SharePoint, you’ll need to be an owner or admin in Slack and an Office 365 administrator.
  • Once a domain is verified, the Slack accounts for all members with an email address on that domain will automatically connect to an app.
  • Members will not be able to disconnect their Google or Office365 accounts when domain-wide authentication is enabled. 

Note: When you authenticate a domain for a calendar app, connected members will be automatically subscribed to event reminder notifications. Members can disable these and set other notification preferences from the app’s Settings.


Step 1: Install a calendar or file app to your workspace

Use the steps in the articles listed below to install a calendar or file app to your workspace:

If your preferred app is already installed, skip ahead to Step 2.


Step 2: Add a domain

From Slack, add your organization's domain to begin the domain-wide authentication process. If your members have email addresses on more than one domain, repeat the steps below for each domain you'd like to add.

Google Calendar

Google Drive

Outlook

OneDrive

  1. From your desktop, hover over   More.
  2. Click  Automations.
  3. Click  Apps, then search for and select Google Calendar. 
  4. From the Home tab, click the Settings button. 
  5. Below Domain-wide Authentication, click Add domain
  6. Enter your company's domain, then click Add
  1. From your desktop, hover over   More.
  2. Click  Automations.
  3. Click  Apps, Search for and select Google Drive. 
  4. Select the Home tab.
  5. Next to  Domain-wide Authentication, click Add domain
  6. Enter your company's domain, then click Add Domain
  1. From your desktop, hover over   More.
  2. Click  Automations.
  3. Click  Apps, then search for and select Outlook Calendar
  4. From the Home tab, click the Settings button. 
  5. Below Domain-wide Authentication, click Add domain
  6. Enter your company's domain, then click Add

Note: Your members’ Slack email addresses must match their Azure UPNs to connect to Outlook Calendar. Please consider this before enabling domain-wide authentication for Outlook.

To add and verify a domain, the email address on your Slack account needs to match the email address associated with your Office 365 administrator account.
  1. From your desktop, hover over   More.
  2. Click  Automations.
  3. Click  Apps, then search for and select OneDrive and SharePoint.
  4. From the Home tab, click the Admin Settings button.
  5. Below Domain-wide Authentication, click Add domain.
  6. Enter your company’s domain, then click Add.

Note: Your members’ Slack email addresses must match their Azure UPNs to connect to OneDrive. Please consider this before enabling domain-wide authentication for OneDrive.


Step 3: Grant Slack access from Google Workspace or Office 365 

After adding a domain, you'll need to grant Slack access to your members' accounts from Google Workspace or Office 365.

Google Calendar

Google Drive

Outlook

OneDrive

If you're not a Google Workspace Super Admin, you'll need one to authorize a domain-wide installation for Slack from the Google Workspace Marketplace and verify ownership of your domain.

Add the Slack app for your domain

  1. From the app's Home tab, click the Settings button. 
  2. Find your domain, then click the URL in the Domain-wide Authentication section. 
  3. When prompted, sign in to your Google Workspace Super Admin account on the domain you'd like to authenticate. If you're not a Google Workspace Super Admin, copy the URL and share it with someone who is. Then, ask them to follow the remaining steps below. 
  4. Click Domain Install
  5. Click Continue
  6. Check the box to accept Google's Terms of Service, then click Accept
  7. Click Done
  8. Return to your workspace and open the Google Calendar app. 


Verify domain ownership

  1. From the app's Home tab, click the Settings button. 
  2. Find your domain, then click the URL in the Verify domain ownership section. 
  3. When prompted, sign in to your Google Workspace Super Admin account on the domain you'd like to authenticate. 
  4. Click Open Slack to return to the Google Calendar app in your workspace.  
If you're not a Google Workspace Super Admin, you'll need one to authorize a domain-wide installation for Slack from the Google Workspace Marketplace and verify ownership of your domain.

Add the Slack app for your domain

  1. From the app's Home tab, find your domain, then click the first URL in the Domain-wide Authentication section. 
  2. When prompted, sign in to your Google Workspace Super Admin account on the domain you'd like to authenticate. If you're not a Google Workspace Super Admin, copy the URL and share it with someone who is. Then, ask them to follow the remaining steps below. 
  3. Click Admin Install
  4. Click Continue
  5. Check the box to accept Google's Terms of Service, then click Accept
  6. Click Done
  7. Return to your workspace and open the Google Drive app. 


Verify domain ownership

  1. From the app's Home tab, find your domain, then click the second URL in the Domain-wide Authentication section. 
  2. When prompted, sign in to your Google Workspace Super Admin account on the domain you'd like to authenticate. 
  3. Click Open Slack to return to the Google Drive app in your workspace.  

If you're not an Office 365 admin, you'll need someone who is to authorize Slack access from Office 365 and verify ownership of your domain. 

Authorize Slack access from Office 365

  1. From the app's Home tab, click the Settings button.
  2. Find your domain, then click the URL below. 
  3. When prompted, sign in to your Office 365 administrator account on the domain you'd like to authenticate. If you're not an Office 365 administrator, copy the URL and share it with someone who is. Then, ask them to follow the remaining steps below. 
  4. Click Accept to grant Slack access to your members' Outlook Calendar accounts. 
  5. Click Open Slack to return to the Outlook Calendar app in your workspace. 


Verify domain ownership

  1. From the app's Home tab, click the Settings button. 
  2. Find your domain, then click the URL below to verify ownership of your domain. 
  3. Check the box to confirm Slack's access to your members' Outlook Calendar accounts.
  4. Click Accept
  5. Click Open Slack to return to the Outlook Calendar app in your workspace. 

Authorize Slack access from Office 365

  1. From the app’s Home tab, click the Admin Settings button.
  2. Find your domain, then click the URL below.
  3. When prompted, sign in to your Office 365 administrator account on the domain you’d like to authenticate.
  4. Click Accept to grant Slack access to your members’ OneDrive and SharePoint accounts.
  5. Click Open Slack to return to the OneDrive and SharePoint app in your workspace.


Verify domain ownership

  1. From the app’s Home tab, click the Admin Settings button.
  2. Find your domain, then click the URL below to verify ownership of your domain.
  3. Check the box to confirm Slack’s access to your members’ OneDrive and SharePoint accounts.
  4. Click Accept.
  5. Click Open Slack to return to the OneDrive and SharePoint app in your workspace.

Note: If you'd like to verify more than one domain, a Slack owner or admin who is also an Office 365 administrator with an email address on the domain will need to follow the steps above.


Step 4: Verify your domain

Google Calendar

Google Drive

Outlook

OneDrive

  1. From the app's Home tab, click the Settings button.
  2. Next to your domain, click Verify
  3. Enter a valid email address on the domain, then click Verify

Tip: If members with email addresses on a verified domain are not already using the Google Calendar app, they’ll receive a series of onboarding messages from the app to help them get started.

  1. Go to the app's Home tab.
  2. Next to your domain, click Verify
  3. Enter a valid email address on the domain, then click Verify

Tip: If members with email addresses on a verified domain are not already using the Google Drive app, they’ll receive a series of onboarding messages from the app to help them get started.

  1. From the app's Home tab, click the Settings button.
  2. Next to your domain, click Verify
  3. Enter a valid email address on the domain, then click Verify

Tip: If members with email addresses on a verified domain are not already using the Outlook Calendar app, they’ll receive a series of onboarding messages from the app to help them get started.

  1. From the app’s Home tab, click the Admin Settings button.
  2. Next to your domain, click Verify.
  3. Enter a valid email address on the domain, then click Verify.

Note: If you're on the Enterprise Grid plan and installed the OneDrive and SharePoint app at the org level, your domain-wide authentication will apply to all workspaces in your org with access to the app.

 

On the Free, Pro and Business+ plans, once you’ve verified your desired domains, setup is complete. Read on to complete the setup for your Enterprise Grid org.


Step 5: Choose workspaces in your Enterprise Grid org

After completing the steps above, Org Owners and Admins must select at least one workspace in their org to complete the domain-wide authentication process for the Google Calendar, Outlook Calendar, and OneDrive and SharePoint apps.

Note: This step is not required for the Google Drive app. Domain-wide authentication will be automatically enabled for every workspace in your Enterprise Grid org once the domain is verified. 

Google Calendar

Outlook

OneDrive

  1. From the app's Home tab, click the Settings button.
  2. Below any domain, click Choose to open the drop-down menu.
  3. Scroll to find a workspace, then click on the workspace name to enable domain-wide authentication for that workspace.


Repeat these steps to enable domain-wide authentication for additional workspaces.

  1. From the app's Home tab, click the Settings button.
  2. Below any domain, click Choose to open the drop-down menu. 
  3. Scroll to find a workspace, then click on the workspace name to enable domain-wide authentication for that workspace. 


Repeat these steps to enable domain-wide authentication for additional workspaces. 

If you installed the OneDrive and SharePoint app at the org level, your domain-wide authentications will apply in all workspaces in your org with access to the app. If the app is installed at the workspace level, you’ll need to set up domain-wide authentication from each workspace where you’d like your members’ accounts automatically connected to the app.


Manage domains

Note: Any owner or admin can manage domains. Owners and admins who added a domain will not be notified if it's removed.

If you no longer want members with email addresses on a certain domain to use a calendar or file app in Slack, or need to remove a domain you're not using anymore, follow the steps below: 

Google Calendar

Google Drive

Outlook

OneDrive

  1. Open the Google Calendar app in Slack.
  2. From the Home tab, click the Settings button. 
  3. Next to the domain you'd like to remove, click Delete
  4. Then, click Delete to confirm. 
  1. Open the Google Drive app in Slack.
  2. Select the Home tab. 
  3. Next to the domain you'd like to remove, click Delete
  4. Then, click Delete to confirm. 
  1. Open the Outlook Calendar app in Slack.
  2. From the Home tab, click the Settings button. 
  3. Next to the domain you'd like to remove, click Delete
  4. Then, click Delete to confirm. 
  1. Open the OneDrive and SharePoint app in Slack.
  2. From the Home tab, click the Admin Settings button.
  3. Next to the domain you’d like to remove, click Delete.

Tip: To uninstall a calendar or file app from Slack, follow the steps in Remove apps and custom integrations from your workspace.

Related Articles

Recently Viewed Articles