We’re renaming ‘products’ to ‘apps’

Atlassian 'products’ are now ‘apps’. You may see both terms used across our documentation as we roll out this terminology change. Here’s why we’re making this change

Connect Outlook Calendar to Rovo

Easily find that ‘as per my previous email’ by bringing your inbox to search.

What is indexed?

The Outlook Calendar connector indexes these objects:

  • Events (30 days in the past and future)

For each object, it indexes these attributes:

  • Event name

  • Date and time

  • Creator

  • Attendees

  • Description

  • URL

This connector does not index calendar attachments.

Before you begin

  • You need Microsoft Entra global admin permissions to connect Outlook Calendar to Rovo.

  • Rovo will always respect permissions. Users will only ever see events that they already have access to.

Connecting to Outlook Calendar

To get to the setup screen for Outlook Calendar in Atlassian Admin:

  1. Go to admin.atlassian.com. Select your organization if you have more than one.

  2. Select Settings > Rovo.

  3. Under the Sites tab, next to the site you want to connect, select More actions ( ••• ) and select Add connector.

  4. Select Outlook Calendar and press Next.

Azure portal

  1. Log in to your Azure portal and navigate to Microsoft Entra ID.

Screenshot of the Manage Microsoft Entra ID option in Azure admin

2. In the side navigation, under Manage, select App registrations > New registration.

If you’ve set up other Entra app registrations for Rovo connectors (such as OneDrive or Outlook Mail), we strongly recommend setting up a new registration for each connector to avoid issues with rate limiting.

Screenshot of App registrations screen in Azure portal with New registration highlighted

3. On the Register an application page in the Azure portal, name the connection to Rovo (for example, “Outlook Calendar Atlassian Rovo”), select Accounts in this organizational directory only, and then select Register.

Screenshot of Azure Portal form for Register an Application, setting up a Rovo app

4. In the side navigation, under Manage, select API permissions, select Add a permission on the API permissions page, then Microsoft Graph.

Screenshot of Request API permissions screen, highlightinng the Add permissions button

5. Select Application permissions and select expand all.

Screenshot of Request API permissions screen with Application Permissions selected

6. Copy the following permissions one by one, and paste them into the search line. Click the checkbox. Repeat for all permissions.

Domain.Read.All Calendars.Read Group.Read.All GroupMember.Read.All User.Read.All

7. Select Add permissions.

Screenshot of Request API permissions screen, highlightinng the Add permissions button

8. There’s one more permission to add, but it’s in a different API. Select Add a permission again, then this time Office 365 Management APIs.

Screenshot of Azure with highlighting for 'Add a permission' and 'Office 365 Management APIs'

9. Select Application permissions, and look for ActivityFeed.Read. Select the checkbox, and select Add permissions.

Screenshot of Application permissions with the ActivityFeed.Read permission ticked

10. Select Grant admin consent for <workspaceName>. 

Screenshot of API permissions screen, with Grant admin consent for <workspacename> highlighted

11. Once this is done, back on the Manage > API permissions screen, in the Status column of the table, you should see green ticks and Granted for <workspace>.

12. Navigate to Manage > Certificates & secrets, and select New client secret and fill in the form.

Screenshot of Azure portal, on the Add a client secret screen

13. Once you’ve created a secret, copy the Value field. You’ll need this soon.

Screenshot of the value field in a new client secret in Azure portal

14. Go to Overview and copy the following details back into the Rovo connector setup screen:

  • Your application ID

  • The directory ID

Screenshot of the overview of an app, highlighting the Directory ID and the Application (client) ID fields.

15. Enter the Client secret value you copied earlier as Client secret.

16. Finally, review the disclaimer, and select Save.

Next steps

After you’ve finished connecting Outlook Calendar:

  1. Events will start to show in Search incrementally over the next few hours.

  2. Your team members will see Outlook Calendar show up as a filter option in Search. If they haven’t connected to Outlook from their Atlassian account, they may be asked to connect before they can see results. This is required so Rovo can make sure your teammates only see events that they already have access to.

  3. Depending on the number of events in Outlook Calendar, it may take some time for all your events to be indexed and appear in Search.

Still need help?

The Atlassian Community is here for you.