Enable domain-wide authentication for calendar apps in Slack

Who can use this feature?
  • Workspace owners/workspace admins and org owners/org admins
  • FreeStandardPlus and Enterprise Grid subscriptions

Workspace owners and workspace admins on the Free, Standard and Plus subscriptions and org owners and org admins on Enterprise Grid can automatically connect all their members' Slack accounts with the Google Calendar or Outlook Calendar apps. 

What to expect

  • Any workspace owner/admin or org owner/admin can start the process of enabling domain-wide authentication for a calendar app, but you'll need help from a G Suite super admin or Office 365 administrator to authorise Slack access for your organisation from G Suite or Office 365. 
  • Once a domain has been verified, the Slack accounts for all members with an email address on that domain will automatically connect to a calendar app. 
  • If members have disconnected their account from a calendar app in the past, their accounts will automatically reconnect. 
  • Members can change which calendar is connected to Slack or disconnect their calendars at any time. 


Step 1: Install a calendar app to your workspace

Follow the steps below to install the Google Calendar or Outlook Calendar app on your workspace. If a calendar app is already installed, move on to Step 2.

Google calendar

Outlook calendar

  1. Visit the Google Calendar page in the Slack App Directory.
  2. Click on Add to Slack
  3. Click Allow to grant Google Calendar access to your Slack workspace. 
  4. When prompted, select Open Slack to return to Slack on your desktop. 
  1. Visit the Outlook Calendar page in the Slack App Directory.
  2. Click on Add to Slack
  3. Select Allow to grant Outlook Calendar access to your Slack workspace. 
  4. When prompted, select Open Slack to return to Slack on your desktop. 


Step 2: Add a domain

Add your organisation's domain to begin the domain-wide authentication process. If members of your workspace or Enterprise Grid org have email addresses on more than one domain, repeat the steps below for each domain that you'd like to add. 

Google calendar

Outlook calendar

  1. From your desktop, click on  Apps in the left-hand sidebar. If you don't see this option, click  More to find it.
  2. Search for and select Google Calendar. 
  3. From the Home tab, click the Settings button. 
  4. Below Domain-wide authentication, click on Add domain
  5. Enter your company's domain, then click Add.

GCal_Domain_Auth_Settings_Modal.png 

  1. From your desktop, click on  Apps in the left-hand sidebar. If you don't see this option, click  More to find it.
  2. Search for and select Outlook Calendar. 
  3. From the Home tab, click the Settings button. 
  4. Below Domain-wide authentication, click on Add domain
  5. Enter your company's domain, then click Add

OCal_Domain_Auth_Settings_Modal.png


Step 3: Grant Slack access from G Suite or Office 365 

Once you’ve added a domain, you'll need to grant Slack access to your members' Google Calendar or Outlook Calendar accounts from G Suite or Office 365.

Google calendar

Outlook calendar

If you're not a G Suite super admin, you'll need someone who is to authorise a domain-wide install for Slack from the G Suite 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 on the URL in the Domain-wide authentication section. 
  3. When prompted, sign in to your G Suite super admin account. If you're not a G Suite 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 on Continue
  6. Tick the box to accept Google's Terms of Service, then select Accept
  7. Click on 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 on the URL in the Verify domain ownership section. 
  3. When prompted, sign in to your G Suite super admin account. 
  4. Click on Open Slack to return to the Google Calendar app in your workspace.  

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

Authorise Slack access from Office 365

  1. From the app's Home tab, click the Settings button.
  2. Find your domain, then click on the URL below. 
  3. When prompted, sign in to your Office 365 administrator account. 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 on the URL below to verify ownership of your domain. 
  3. Tick 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. 


Step 4: Verify your domain

Google calendar

Outlook calendar

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


Step 5: Choose workspaces in your Enterprise Grid org

After completing the steps above, org owners and org admins must select at least one workspace in their org to complete the domain-wide authentication process. 

Google calendar

Outlook calendar

  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. 


Calendar app onboarding for members

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

  • Firstly, members will be notified that a calendar app is available for them to use in Slack. If they like, they can switch the calendar connected to Slack or disconnect their account. Any members who disconnect their account will not receive additional onboarding messages. 
  • Next, members will be prompted to enable status syncing. When status syncing is enabled for Google Calendar or Outlook Calendar, members' Slack statuses will automatically update to reflect that they're in a meeting based on their calendar. 
  • Lastly, members will receive information about customising their calendar notification settings in Slack. 


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 app in Slack, or need to remove a domain that you're not using anymore, follow the steps below: 

Google calendar

Outlook calendar

  1. Open the Google Calendar app in Slack.
  2. From the Home tab, click the Settings button. 
  3. Next to the domain that you want to remove, click on 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 that you want to remove, click on Delete
  4. Then, click Delete to confirm. 

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