Skip to main content

Set up Office 365 calendar integration

  • 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 under and an Administrator account.
  2. Click Azure Active Directory in the left-hand panel.
  3. Click App Registrations. You may be presented with 2 options for app registrations for Office 365 as Microsoft is updating their app registration feature. Please select the option App Registrations (Legacy).
  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 Type, choose Web app/API.
  7. Enter into the Sign-on URL field.
  8. Click Create. You'll see a new summary pane with 6 entries:NewCalendarApp.png
  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 Settings icon in the app's summary pane.
  2. In the Settings pane, in the API Access list, click KeysGenerateKey.png
  3. In the Passwords section, enter a name for the Key description of a new Key.
  4. Select either 1 year or 2 years for the expiration date.
  5. Click Save to generate the key's value.
  6. 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 Settings pane, in the API Access list, click Required permissions
  2. In the Required permissions pane, click +Add.AddNewAPI.png
  3. In the Add API access pane, click Select an API.
  4. In the Select an API pane, choose Microsoft Graph.ChooseAPI.png
  5. Click Select.
  6. Back in the Add API access pane, click Select permissions.AssignPermissions.png
  7. In the Enable Access pane, select these permissions:
    • Read directory data
    • Read and write calendars in all mailboxes
  8. Click Save.
  9. In the Add API Access pane, click Done.
  10. In the Required permissions pane, click Grant Permissions.Screen Shot 2018-05-22 at 11.49.14 AM.png
  11. Click Yes.


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., 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.