---
title: Email connection using MS Graph API
slug: v111/email-connection-using-ms-graph-api
createdAt: 2026-05-14T00:19:07.317Z
---

# 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:

:::hint{type="info"}
As required, please grant admin consent to the respective permissions
:::



::Image[]{src="https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/j0IDw8GW4V0z2sMZDOk37_image.png" size="48" width="1224" height="318" position="center" darkWidth="1224" darkHeight="318" showCaption="false"}

Also set a new Client secret for the App registration and keep a temporary copy for the Servicely configuration below.

:::hint{type="info"}
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](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                                                             | Email                                        |
| 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                                        | someemailaddress\@somecompanyname.com        |
| 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.

:::hint{type="info"}
If the mailbox you are connecting to is newly created, you may need to wait several hours to ensure propagation in the Microsoft infrastructure.
:::