Skip to content
English
  • There are no suggestions because the search field is empty.

How to Set Up Outlook Calendar & Microsoft Teams Integration

This guide explains how to connect your Microsoft 365 environment to PushFar, enabling Outlook Calendar availability checking and optional Microsoft Teams meeting creation.

 
 

Before You Start

You will need:

  • A Microsoft 365 Global Administrator account (or appropriate Azure permissions)
  • Access to your organisation's Microsoft Entra Admin Centre
  • Access to the PushFar Company Dashboard

Best Practice: Mixed Email Environments

For the best experience, we recommend using Outlook Calendar integration where both mentors and mentees are part of the same Microsoft 365 environment.

Organisations operating a mixture of email and calendar platforms (for example, Microsoft 365 alongside Google Workspace or other providers) may experience reduced functionality or inconsistent results when checking participant availability.

 

Choose Your Integration Type

 

Outlook Calendar Integration

This option allows PushFar to:

    • Check participant availability
    • Suggest mutually available meeting times
    • Display diary conflict warnings

Required Permission:

          • Calendars.Read

Microsoft Teams Integration

This option includes all Outlook Calendar functionality plus:

    • Automatic Teams meeting creation
    • Calendar invitation synchronisation
    • Meeting acceptance and decline updates
    • Removal of cancelled meetings from calendars

Required Permissions:

          • Calendars.ReadWrite
          • OnlineMeetings.ReadWrite.All

 

Steps to setup

 

Step 1: Create or Locate the Azure Application

  1. Sign in to the Microsoft Entra Admin Centre.
  2. Navigate to ApplicationsApp registrations.
  3. If you have previously configured PushFar Single Sign-On, you may use the existing PushFar application.
  4. Otherwise, select New registration.
  5. Enter a name such as PushFar.
  6. Complete the registration.

Step 2: Configure Microsoft Graph Permissions

  1. Open the PushFar application registration.
  2. Select API permissions.
  3. Click Add a permission.
  4. Select Microsoft Graph.
  5. Select Application permissions.

For Outlook Calendar Integration

Add:

      • Calendars.Read

For Microsoft Teams Integration

Add:

      • Calendars.ReadWrite
      • OnlineMeetings.ReadWrite.All
      1. Click Add permissions.
      2. Click Grant admin consent for your organisation.

Step 3: Create a Client Secret

  1. In the application registration, select Certificates & secrets.
  2. Click New client secret.
  3. Enter a description such as PushFar Integration.
  4. Choose an expiry period that aligns with your organisation's security policies.
  5. Click Add.
  6. Copy and securely store the generated secret value.

Important: The client secret value is only shown once and will be required when configuring PushFar.

 

Step 4: Gather Your Application Details

  1. From the application's Overview page, copy the following values:
  • Application (Client) ID
  • Directory (Tenant) ID

You should now have:

        • Client ID
        • Tenant ID
        • Client Secret

Step 5: Configure PushFar

  1. Log in to the PushFar Company Dashboard.
  2. Navigate to: Configuration → Calendar Integration → Outlook
  3. Enter:
    • Client ID
    • Client Secret
    • Tenant ID
  4. Enable Microsoft Teams integration if required.
  5. Click Save Configuration.

Step 6: Test the Integration

We recommend testing with two users before enabling the integration across your entire programme.

Confirm that:

  • Availability is displayed correctly.
  • Suggested meeting times are shown.
  • Conflict warnings appear when appropriate.
  • Teams meeting links are generated (if Teams integration is enabled).
  • Meeting invitations are received in Outlook.

 

 

Restricting Access to Specific Users (Optional)

 

If you do not want the integration to access all users within your Microsoft 365 environment, Microsoft provides Application Access Policies.

These policies allow you to restrict access to members of a specific Microsoft Entra security group.

For Microsoft's guidance on configuring access policies, see:

Microsoft Learn - Limit Application Access to Mailboxes

 

Need Help?

 

If you experience any issues configuring the integration, please contact the PushFar Support Team with:

  • The permission set configured in Azure
  • Any error messages shown in PushFar
  • Whether you are enabling Outlook Calendar integration only or Outlook Calendar and Microsoft Teams integration together

This will help us diagnose and resolve any issues more quickly.