Overview

The Microsoft Outlook connector for Gemini Enterprise lets you access your Microsoft Outlook or Office 365 data and interact with mail, calendars, and contacts.

Supported Microsoft Outlook versions

The Microsoft Outlook data store supports Microsoft Graph API v1.0 with IDP integration.

Supported actions

When the Microsoft Outlook data store is enabled, end users can use natural language commands in Gemini Enterprise to perform the following actions.

Action Description
Create Event Creates a new event.
Update Event Updates an existing event.
Send Mail Sends an email message. This includes sending email with attachments.

In addition to these, additional read-only actions are available.

Required permissions

The following table outlines the permissions required for Microsoft Outlook search and actions.

Connection mode Permission Purpose
Federated search Mail.Read
Calendars.Read
Contacts.Read		 (Delegated) Allows the connector to read the signed-in user's mailbox, calendar events, and contacts.
Data ingestion Calendars.Read (Application) Allows the connector to read events of all calendars.
Calendars.ReadBasic.All (Application) Allows the connector to read events of all calendars, except for properties such as body, attachments, and extensions.
Contacts.Read (Application) Allows the connector to read all contacts in all mailboxes.
Mail.Read (Application) Allows the connector to read mail in all mailboxes.
Mail.ReadBasic (Application) Allows the connector to read basic mail properties in all mailboxes. Includes all properties except body, previewBody, attachments and any extended properties.
Mail.ReadBasic.All (Application) Allows the connector to read basic mail properties in all mailboxes. Includes all properties except body, previewBody, attachments and any extended properties.
User.Read (Delegated) Allows the connector to read the profile of signed-in users.
User.Read.All (Application) Allows the connector to read the full set of profile properties, reports, and managers of other users in your organization.
User.ReadBasic.All (Application) Allows the connector to read a basic set of profile properties of other users in your organization.
Actions Mail.Send (Delegated) Allows the connector to send mail as users in the organization.
Calendars.ReadWrite (Delegated) Allows the connector to create, read, update, and delete events in user calendars.
Contacts.ReadWrite (Delegated) Allows the connector to create, read, update, and delete user contacts.

For information on how to add the permissions for Microsoft Outlook, see Configure Microsoft Outlook and set the necessary permissions.

Rate limits for data ingestion

The request volume limit is 10,000 API requests per 10-minute period. These rate limits apply exclusively to the Microsoft Outlook connector when you choose to use ingestion as the connector mode.

Limitations

This section outlines known issues and limitations that may affect your use of the Microsoft Outlook connector.

  • Enforcing a VPC Service Controls perimeter on existing Microsoft Outlook data stores is not supported. To enforce VPC Service Controls, you must delete and recreate the data stores. For more information on VPC Service Controls and how to use actions after enabling VPC Service Controls, see Secure your app with VPC Service Controls.

  • The Microsoft Outlook data store is supported only in Global, US, and EU locations.

  • When creating a new application or adding a data store to an existing application, we recommend that you add a data store with actions belonging to a single connector type. For example, don't associate two Microsoft Outlook data stores with actions enabled to the same application.

  • The Microsoft Outlook connector can process one transaction per second, per node, and throttles any transactions beyond this limit.

  • The connector's ability to retry on rate-limit exceeded errors is dependent on receiving a "retry-after" value from the Microsoft Graph API, which is only provided for the Outlook connector. The default number of retry attempts is three.

  • The throughput is limited by API call restrictions imposed by Microsoft Graph. Limits apply to each app ID and mailbox combination—that is, a specific app accessing a specific user or group mailbox. Exceeding the limit for one mailbox doesn't affect the ability of the application to access another mailbox.

What's next