Welcome to the Microsoft Exchange Connector setup guide! This document serves as a comprehensive guide for configuring Microsoft Exchange to integrate seamlessly with Savant using the methods mentioned below.
Features
Read access to manage emails, folders, and shared mailboxes.
Write access to send emails as a user or on behalf of someone.
Retrieve specific messages or folders via Graph API.
Requirements
To establish a connection between Savant and Microsoft Exchange, the following prerequisites must be met:
Access to a valid Microsoft Outlook account.
Permissions for the following Microsoft Graph API scopes:
Mail.ReadWriteMail.ReadWrite.SharedMail.SendMail.Send.Shared
Basic understanding of OAuth authentication.
Familiarity with the Microsoft Graph API.
Connection Methods
Savant supports secure access to Microsoft Exchange using:
OAuth Authentication
Step 1: Register an App in Microsoft Exchange
Navigate to the Azure portal: Microsoft Azure Portal.
Click New Registration.
Provide the following details:
Name: Savant Exchange Integration
Redirect URI: Use the appropriate URI based on your region:
For EU applications:
https://app-eu.savantlabs.io/api/callbackFor others:
https://app.savantlabs.io/api/callback
Note down the Client ID and Tenant ID.
Go to Certificates & Secrets and generate a new client secret. Save it securely.
Step 2: Set Permissions for the App
Navigate to API Permissions in the app settings.
Add the following permissions:
Microsoft Graph > Delegated Permissions:
Mail.ReadWriteMail.ReadWrite.SharedMail.SendMail.Send.Shared
Grant admin consent for these permissions, if required.
Step 3: Authenticate in Savant
Go to Systems in Savant and click Add System.
Select the Microsoft Exchange Connector and click Next.
Enter the following details:
Client ID
Client Secret
Tenant ID
Click Authenticate and follow the prompts to complete the authorization.
Supported Data Model
Tables
CalendarGroupsCalendarsContactsEventsExtendedPropertiesGroupsMailFoldersMessagesUsers
Views
CalendarViewEventAttachmentsEventInstancesMessageAttachments
Supported Schema, Objects, and Fields
Schema | Object | Fields (Data Type) |
Archive | Emails | See Notes Below |
Drafts | Emails | See Notes Below |
Inbox | Emails | See Notes Below |
Field Examples:
@odata.etag(Text)Id(Text)Created Date Time(DateTime)Last Modified Date Time(DateTime)Subject(Text)Body Preview(Text)From(JSON)To Recipients(JSON)
Troubleshooting
Authentication Issues: Verify the client ID, secret, and permissions.
Data Retrieval: Ensure correct folder names or IDs are used in API requests.
Permission Denied: Double-check API permissions in the Azure portal.
Common Endpoints:
Retrieve messages from a folder by name:
https://graph.microsoft.com/v1.0/me/mailFolders/{folder_name}/messagesRetrieve messages by folder ID:
https://graph.microsoft.com/v1.0/me/mailFolders/{folder_id}/messages
Refer to Microsoft documentation for detailed Graph API specifications.
Don’t see what you’re looking for? Contact us in the Community or reach out in Chat Support