Syncing Events with Outlook Calendar

This topic covers syncing events between Discourse and Outlook Calendar. Here’s a video of me setting that up:

Setting up the connection

The first step is to set up the connection with Outlook Calendar

Set up Azure

You’ll need an Azure account that has access to the calendar(s) you want to sync. If you haven’t created an account yet go to portal.azure.com and sign up with a Microsoft account that can administer the calendar(s) you want to sync. Once you have an Azure account, follow these steps:

  1. Go to the App Registrations page
  2. Click “New Registration”
  3. Enter a name (any name)
  4. Select the “Accounts in any organizational directory…” permission
  5. Enter a redirect URI with the path: /admin/plugins/events/provider/redirect. For example:
    https://test.angus.blog/admin/plugins/events/provider/redirect
    
  6. Click “Register”
  7. Copy the Client ID from the App Registration page
  8. Back on the Azure App Registration page, click “Add a certificate or secret” next to “Client credentials”, click “New Client Secret” and create a new long-lived secret. Copy the secret “value”.

Set up Outlook Calendar Provider

Now go to the Events Plugin admin panel in your Discourse and click on “Providers”. Enter the “Client ID” (client_id) and “Client Secret” (client_secret) you copied in the previous step, click “save” on the right.

Once your Outlook Calendar Provider has appropriate credentials click “Authenticate” to initiate the authentication process. You’ll be asked to sign in (if not already), then consent to the Events Plugin accessing your application data. Once you’ve consented you’ll be redirected back to the Events Plugin admin panel and you should now see a “Ready” status in the Outlook Calendar provider row.

Setting up the event sync

Once you’ve set up Google Calendar as a provider click on “Sources” in the Events Plugin admin panel and click “+ Add Source”.

The options you select here will depend on what kind of sync you want. Each option has a short description under it, and some of those descriptions will update when you change the selection to give you further details on what your selection means. We’ll go over the options specific to Outlook Calendar here. If you want further information on other options, or help setting up a Source for a specific use case, please reach out to @angus

How to get Outlook User and Calendar IDs

Use the Graph Explorer to get the User and Calendar IDs: