Integrate mailboxes from Microsoft 365 and Google Workspace
Updated Reading time: 2 min
On this page
With the "Mailboxes" function of the Office suite, mailboxes from Microsoft 365 or Google Workspace appear in the platform's webmail. The emails remain with the provider. The platform displays them live and sends them via your app.
What works in webmail#
An integrated mailbox has the same functions as a platform mailbox: folders, search, drafts, attachments, follow-up, follow-up reminders, comments, and Kai.
1. Rights in the provider's app#
The platform uses the same app that you created for calendar synchronization. Add the rights for email there.
Microsoft 365 (Microsoft Entra)#
Right |
Type |
Purpose |
|---|---|---|
|
Application |
Read and manage emails |
|
Application |
Send emails |
|
Application (optional) |
Only for the out-of-office notice |
Then grant admin consent for your organization.
Info
You can limit the app's access to specific mailboxes (RBAC for applications in Exchange Online). To do this, you must revoke organization-wide consent. Changes take effect at Microsoft after 30 minutes to 2 hours.
Google Workspace#
In the Google Admin console, under Security → API Controls → Domain-wide Delegation, grant the service account these additional scopes:
https://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/gmail.sendhttps://www.googleapis.com/auth/gmail.settings.basic(optional, for out-of-office notice and signatures)
2. Enable "Mailboxes" function#
Open Administration → Integrations.
Open the card for your Office suite (MS 365 or G-Suite).
Under "Functions," enable the "Mailboxes" function.
The platform checks whether the rights are available and displays missing rights directly.
Warnung
If you disable "Mailboxes," all Microsoft or Google mailboxes will be suspended. The connections remain intact. In webmail, it will then say "External mailboxes are currently disabled in administration."
3. Assign mailbox#
Open Administration → Mail, "Mailboxes" tab.
Click on "Create mailbox."
Select "Mailbox type" as Microsoft 365 or Google Workspace.
Enter the "Email address at the provider" and select who owns the mailbox: a person or a group.
Save. The platform immediately checks whether the app is allowed to read the mailbox.
A personal mailbox occupies a mailbox license, while a group mailbox does not. You can book licenses under Administration → Mail in the "General" tab under "Personal Mailboxes."
If a mailbox is not accessible#
If the platform cannot read a mailbox, webmail will display "This mailbox is not accessible," and administration will show "This mailbox needs attention." Possible reasons:
The app lacks permission for this mailbox.
The connection to the mailbox was disconnected. Please reconnect.
The mailbox no longer exists with the provider.
External mailboxes are disabled in administration.
Fix the cause with the provider and click "Check again."