Enable faster Microsoft 365 synchronization
MailDesk can subscribe to Microsoft Graph change notifications, so new Outlook or Microsoft 365 mail arrives within seconds instead of at the next scheduled sync.
Who this is for: MailDesk administrators.
You need: MailDesk Pro, the Mailbox administrator access group, and a mailbox connected over Microsoft Graph (not classic IMAP).
Before you begin
- Connect the mailbox with the Microsoft Graph option and check that it syncs. See Connect Microsoft 365 / Outlook.
- Make your Odoo address public HTTPS. See Set up HTTPS for faster synchronization. Microsoft sends a validation request to the webhook when you register.
- Keep the scheduled sync jobs on. They are the fallback.
Use the Graph connection, not IMAP
A token for classic IMAP/SMTP access cannot create Graph subscriptions. If the mailbox uses an IMAP-only Microsoft token, the assistant stops and asks you to reconnect with the Microsoft Graph option.
What push does
Microsoft tells MailDesk that the mailbox changed. The notification does not contain the email. MailDesk then runs its normal sync for that mailbox.
Set up Microsoft 365 push
- Open the Enable Microsoft 365 push notifications assistant for the mailbox.
- Check the three items on the screen: the mailbox account, the read-only webhook URL (built from
web.base.url), and the readiness check. - If the readiness check passes, click Register Subscription.
What you should see: the subscription id and its expiry date.
When you click Register Subscription, MailDesk creates a fresh secret for this subscription, asks Microsoft Graph to create the subscription, answers Microsoft's validation request, and saves the id and expiry date.
Where to open the assistant
This assistant is not shown as a button on the mailbox account form in the version we checked. If you cannot find it, ask your Metzler IT contact how to open it for your installation. Without push, the mailbox keeps syncing on the schedule (about every 3 minutes).
The subscription is registered for about 6 days. MailDesk renews it automatically when less than 24 hours remain.
If it does not work
| Symptom | Likely cause | Safe next step |
|---|---|---|
| Register Subscription is missing | The readiness check did not pass | Read the reason on the screen. Usually you must reconnect with the Microsoft Graph option. |
| The reason mentions IMAP or a wrong token | The mailbox uses a classic IMAP/SMTP token | Reconnect the mailbox with the Graph option. |
| Registration fails with a Graph error | Microsoft could not validate the webhook, or the authorization is out of date | Check web.base.url. Reconnect the mailbox if needed, then try again. |
| The validation handshake fails | Microsoft cannot reach the webhook over HTTPS | Run the curl check on the HTTPS page, but use /maildesk/push/outlook. |
| No fast mail after setup | A notification was missed | Mail still arrives on the scheduled sync. See Fix missing or delayed emails. |
Next step
Fix missing or delayed emails if mail is late, or go back to How quickly email synchronizes.