Skip to content
DutiesBook API
Open app

Microsoft 365 overview

The Microsoft 365 integration connects your Outlook email accounts to DutiesBook, letting your team manage email conversations alongside WhatsApp, Messenger, and other channels — all in one place.

Receive emails

Incoming emails are delivered as conversations in DutiesBook and routed to the right team or agent automatically.

Send emails

Send emails to contacts via the external API using your connected Microsoft 365 account — with full HTML or plain-text body support.

Real-time notifications

Microsoft Graph API webhooks push new email events instantly. No polling required.

Secure OAuth 2.0

Accounts connect through Microsoft’s standard OAuth consent flow. No passwords stored — only encrypted, revocable access tokens.

Once connected, the account appears as a channel with type microsoft365 in your channel list. Use the channel UUID in all API requests that target this integration.

{
"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "microsoft365",
"status": "connected",
"email": "[email protected]",
"displayName": "Support Inbox"
}

Before you connect

  • A Microsoft 365 account (personal or work/school)
  • The account must have an active Outlook mailbox
  • You must have Owner or Admin access in DutiesBook to add channels

Required mail permissions

During the OAuth consent screen, Microsoft will request the following permissions: Mail.Read, Mail.ReadWrite, Mail.Send, and User.Read. All four are required for the integration to function.

When a new email arrives in the connected inbox, Microsoft Graph sends a change notification to DutiesBook via webhook. DutiesBook fetches the message, creates or updates the corresponding contact, and opens a conversation that your team can reply to.

When you send an email through the external API, DutiesBook forwards it via the Microsoft Graph sendMail endpoint using the stored access token for that channel. If the access token has expired, it is automatically refreshed using the stored refresh token before sending.