Email connection using MS Graph API
Overview
Servicely supports both inbound/outbound email connectivity with Microsoft hosted email inboxes, using Microsoft's Graph API.
Configuration
Entra
On Entra's side, an App registration is to be created for this with the following API Application type permissions:
As required, please grant admin consent to the respective permissions
Also set a new Client secret for the App registration and keep a temporary copy for the Servicely configuration below.
It is recommended to setup Application access policy to scope the API permission above, only to the inbox(es) Servicely needs to read from/send as. You may refer to Microsoft's documentation such as: https://learn.microsoft.com/en-us/graph/auth-limit-mailbox-access
Servicely
Once the App registration on Entra is set-up, you can configure a new Messaging account record:
Field name | Description | Example value |
|---|---|---|
Name | Meaningful name for the configuration | [PROD] Email via Graph |
Provider | Channel type | |
Type | Communication mean, set to "Microsoft Graph API (Inbound/Outbound Email) | Microsoft Graph API (Inbound/Outbound Email) |
Active | Set to Yes to activate | Yes |
Username | Email address Servicely is to use | |
Tenant Id | Tenant ID of your Entra | zz8933c6-cfb2-4zz9-afc9-021abc1dea0z |
App secret | Client secret from the Entra App registration setup | |
Client Id | Application (client) ID of the Entra App registration | zyxa9be7-5501-4ff6-82c5-aa09d9a23a14 |
Once the Messaging account is configured, you can clicked on "Test" button to test the connection.
If the mailbox you are connecting to is newly created, you may need to wait several hours to ensure propagation in the Microsoft infrastructure.