---
title: "Setting up Microsoft 365 email"
description: "This article describes the steps your IT administrator needs to carry out to connect Microsoft SMTP types such as Outlook, Hotmail and Office 365."
url: https://helpcentrum.crossuite.app/en/articles/219-setting-up-microsoft-365-email
collection: "Email communication"
updated: 2026-11-19
language: en
alternates: [nl, fr]
---

# Setting up Microsoft 365 email

This article describes the steps your IT administrator needs to carry out to connect Microsoft SMTP types such as Outlook, Hotmail and Office 365.

## **Setting up Microsoft 365 email**

First connect Crossuite to your email address. To do this, go to Settings > Communication > Email address configuration and edit the email address in the list with the pencil icon.

Set the “Email provider” to Microsoft 365 and log in with your Microsoft account.

If you get a message that the administrator still needs to give consent, they can grant it via [https://entra.microsoft.com/](https://entra.microsoft.com/) under Enterprise apps > Admin consent requests.

![Microsoft Entra admin screen 'Admin consent requests' showing the Crossuite app under 'My pending actions'.](https://staticfiles.gleap.io/ghelparticle/70uC8yAQXzPFMzhfGfDmIjEAglruMEbobqtksScQVvMhUFoukzPcQZHvZotsEs30eGsNBgQL9Pn.png)

Once your IT administrator has given consent, log in to your Microsoft account again via Settings > Communication > Email address configuration.

Then click the “Verify configuration” button.

![Email configuration screen with Office365 as provider and the status 'Not connected'; the Microsoft sign-in button and 'Verify configuration' are highlighted.](https://staticfiles.gleap.io/ghelparticle/uVs7VxazhdX2IE975KUfXXvz1w6pwlClTBwbFFh5ZdX3e1CJ7CFj5zxoZQIZzIpNIff4TQrCGSF.png)

If you get a green message, the email connection works and your emails will reach patients successfully.

If sending emails still causes problems or error messages, not all settings of your Microsoft account may be configured correctly yet. Your IT administrator can fix this by following the steps below.

## Steps for the email administrator in case of errors or complications

### **Step 1:** [**Open the Microsoft 365 admin center**](https://admin.microsoft.com/Adminportal/Home#/users)

In the left menu, go to Users → Active users. Click the user of the email address that Crossuite uses.

Open Licenses and apps and check that a suitable licence is assigned, such as Microsoft 365 Business Standard or Exchange Online.

![The Licenses and apps tab with Belgium selected and the Exchange Online subscription checked under Licenses.](https://staticfiles.gleap.io/ghelparticle/hj8MChEKaSaURK6h9dBTx7WeO5MO0Bds6yHQsCqCmNMf1CcCSvNoOfJWTEynRxrKn2CMoK1iYNm.png)

If the mailbox does not have an Exchange Online licence, the email administrator first needs to activate it.

In the same screen, open the Mail tab next to “Licenses and apps”. Click Manage email apps.

![The Mail section of an account showing mailbox storage, mailbox permissions and allowed email apps; the Mail tab and Manage email apps are highlighted.](https://staticfiles.gleap.io/ghelparticle/tPDaR0Z5xqCny7dvIj9XQgnx5gSnDrOIUvmoKtkGIDdavGSxure8wq4MvTN2lrCgeCzx74MdevV.png)

Check the “Authenticated SMTP” box here.

![Microsoft 365 Manage email apps screen with checked access options; the Authenticated SMTP option is highlighted.](https://staticfiles.gleap.io/ghelparticle/2Ztl8pnh3f0Ik9CYqC5oyVVbKalRDhJqHIGkmno3px95JAuLP4Pg6dQyA0jm8sLR52JQRyjTYzS.png)

### **Step 2: Go to the** [**Microsoft Entra admin center**](https://entra.microsoft.com/)**.**

Go to Entra ID → Enterprise applications → All applications. Click Crossuite.  
Click Properties on the left and set the following 2 values:

<table style="min-width: 497px;"><colgroup><col style="width: 66.67%;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p><strong>Setting</strong></p></td><td colspan="1" rowspan="1"><p><strong>Value</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p>Enabled for users to sign in?</p></td><td colspan="1" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Assignment required?</p></td><td colspan="1" rowspan="1"><p>No</p></td></tr></tbody></table>

![Properties screen of the Crossuite application showing that sign-in is enabled and assignment is not required; both settings are highlighted.](https://staticfiles.gleap.io/ghelparticle/O1CIegCAHdetAV57QLf6FgCx4fMX4Q65senjrEL4xebTLBwB36d4bPUOz3lw36xasUEVemWD4OL.png)

**Check the API permission**

1.  Go to the [Microsoft Entra admin center](https://entra.microsoft.com/).
    
2.  Open Entra ID → Enterprise applications → All applications.
    
3.  Search for and open Crossuite.
    
4.  Click Permissions on the left.
    
5.  At the top of the page, look for the Grant admin consent button. Click this button, even if consent has already been given.
    

### **Step 3.** Go to [https://admin.exchange.microsoft.com](https://admin.exchange.microsoft.com).

On the left, go to Settings > Mail flow. Uncheck ‘Turn on use of legacy TLS clients’ and save.

### **Step 4. Log in to Crossuite again.**

Once all of this is set up, log in to Crossuite again in an **incognito tab**.  
Go to Settings > Communication > Email address configuration and edit the email address in question with the pencil icon.  
  
Make sure the SMTP type is set to Office365 and log in with your Microsoft account.  
  
First log out of your Microsoft account here, then log in again. Then click “Verify configuration”. Emails should now arrive again without error messages.
