Microsoft 365 Graph Email

Connect a Microsoft 365 account (formerly “Office 365”) via Graph API to Zammad.

Email settings panel

Hint

What is the difference between the Graph-API- and IMAP-based M365 channel?

The Graph-API variant has some advantages over the IMAP-based channel:

  • Shared mailboxes are implemented in a better way. By using them, you can save some license costs.

  • The selection of an inbox folder is implemented with a tree-select field in Zammad. So you can choose a folder from the fetched folder list, which is much less error-prone.

  • It is the future-proof way of connecting to your M365 environment.

  • It is more secure and scalable and offers a unified endpoint.

So, if you are in doubt which one to use, we recommend using the Graph channel.

Note

Microsoft 365 channels are a specialized kind of 📨 email channel.

This documentation part does not cover 🗝 user authentication.

If you’re already familiar with email channels, you can skip most of this - but watch out for the “Accounts” section, which has a few extra quirks due to Microsoft’s strict security measures.

👥 Accounts

Connect Zammad to your email provider so that it can watch your inbox, send auto-replies, and more.

(Self-hosted users may have already completed this step during new system setup.)

🗂️ Filters

Make sure new tickets show up in the right place with automated, if-this-then-that rules for all incoming email.

📜 Signatures

Customize signatures for all outgoing email.

⚙️ Settings

Manage options like:

  • set the “From:” address on system notifications

  • raise the limit on attachment sizes

  • modify subject-line prefixes (e.g., use “AW:” instead of “RE:”)

Hint

Want to manually edit email subjects or always copy parent messages into your replies?

Check the ✍️ Composer Settings.

📇 Header based actions

Manipulate auto response behavior or incoming routing.

Warning

🤓 This is a very advanced topic.

🛟 Common M365 errors

Here you can find common errors and how to fix them.