Skip to main content
SmartRecruiters

Set up Office 365 calendar integration

Requires:
  • SmartRecruit

 

In order to set up the Microsoft Office 365 Calendar integration, you'll need to have:

  • an Administrator-level account in SmartRecruiters,
  • a subscription to Microsoft's Azure Management Portal, and
  • the user saving the credentials in SmartRecruiters must have an account in the active directory that the integration is being configured for

There are two steps to integrating your company's Office 365 Calendar with SmartRecruiters:

  1. Register SmartRecruiters as an App in Azure.
  2. Add the App's credentials to SmartRecruiters.

When you enable a calendar integration, you give SmartRecruiters permissions to read and write ALL calendar data in your organisation. However, SmartRecruiters' integration pulls only a minimal subset of required data. Due to the technical limitations of Microsoft's calendar services, we cannot limit or configure the scope of permissions allowed by the integration.

Register Azure App

You'll need to register SmartRecruiters as an App to get two pieces of information:

  1. Application ID
  2. Client Secret Key

You may need assistance from your Azure Portal Administrator in order to register a SmartRecruiters app in Azure.

Create the app

First, you'll need to register the app itself:

  1. Log in to https://portal.azure.com under and an Administrator account.
  2. Click Azure Active Directory in the left-hand panel.
  3. Click App Registrations. 
  4. Click + New Application Registration at the top of the page.
  5. In the Create pane, enter a name for the app, e.g., SmartRecruiters Calendar Integration.
  6. For Supported account types, choose Accounts in this organizational directory only.
  7. Enter https://www.smartrecruiters.com into the Redirect URL field.
  8. Click Register. You'll see a new summary pane with 8 entries:
  9. Copy the Application ID. 

Generate Secret Key

Now, you'll need to generate a security key that's specific to the app:

  1. Click the Certificates & secrets icon in the app's options pane.
  2. In the Client secrets section click + New client secret, enter a name for the Key description of a new Key.

  3. Select either 1 year or 2 years for the expiration date.

  4. Click Add to generate the key's value.

  5. Copy the key's value. You won't be able to retrieve it later.

Assign Permissions

Finally, you'll need to give the app permission to read your company's calendar:

  1. In the options pane, click API permissions
  2. In the API permissions section, click +Add a permission.
  3. In the Select an API pane, choose Microsoft Graph.
  4. Back in the Request API permission pane, click Application permissions.
  5. In the Select Access section, select these permissions:

    • Directory.Read.All - Read directory data

    • Calendars.ReadWrite - Read and write calendars in all mailboxes

  6. Click Add permissions.

  7. In the Grant consent section, click Grant admin consent for company.
  8. Click Yes.

Done!

Add credentials

Once you've registered an SmartRecruiters app in Azure and copied down the Application ID, and Secret key, enter them into SmartRecruiters. 

  1. Navigate to Settings / Admin.
  2. Click Calendar Integrations in the Configuration list.
  3. Click the MSFT Office 365 Integration tab.
  4. Enter the Application ID from the Azure app into the Client ID field.
  5. Enter the key into the Client Secret field.
  6. Enter your full Tenant ID, e.g., SmartRecruiters.onmicrosoft.com into the Tenant ID field.
  7. Click Save, then Load Resources.

If the setup is successful, you'll see a list of rooms and reservable resources from your calendars. Contact Support to complete the integration.

Click on the following to see the Technical FAQ for Office 365.