Please be aware, this feature is only available on v17.0.0 and above. You can find information about upgrading/patching here.
Prerequisites
This document assumes you have configured mail in your intranet to use the Microsoft Graph API. For more information about configuring mail to use Graph, see Microsoft Graph Mail Configuration and Admin Controls.
Note: If you are using SMTP setup, this dashboard will appear empty.
Navigating to the Mail Dashboard
The Graph Mail Queue Dashboard is your central hub for monitoring outgoing email activity and can be found for Administrators or Super Administrators by navigating to Site Admin | Extensions | Graph Mail Dashboard.
Understanding the Email Queue
The email queue is at the heart of Graph Mail. Instead of sending emails immediately, they're queued for reliable processing, allowing administrators to view all outgoing mail and perform actions on failed emails from within the intranet.
Why use a queue?
- Reliability: If sending fails, the email isn't lost.
- Retry Logic: Automatically retry failed emails.
- Rate Limiting: Prevent overwhelming the email system.
- Monitoring: Track all email activity in one place.
- Testing: Use test modes to verify emails before production.
The email lifecycle:
An email will go through 5 possible stages in the queue, four of which are visible in the UI and one that happens quickly behind the scenes during queue execution.
- Queued: The email has been added to the queue and is waiting for the next scheduled task run to be processed.
- Processing: The scheduled task is currently running an active instance and is actively sending the current email, contacting Microsoft Graph API, and uploading any attachments if present. (Not visible).
- Accepted: Microsoft Graph API has received the email successfully and returned a 202 response code. The email will be on its way to the intended recipients.
- Failed: The email could not be received/sent by the Graph API and will be retried if the retry count is less than the maximum attempts set up in the configuration.
- Discarded: This is mail that has been sent while the configuration is set up in 'Discard Mode'; the email will never have been sent but remains in the queue until the set cleanup date is met for auditing or review.
Dashboard Overview:
At the top of the dashboard you will see four summary cards, these cards provide a quick snapshot of your email queue health, and correspond to the stages mentioned above. These cards will have their count updated based on the time period filter selected.
Table Columns:
- ID: Unique identifier for each email
- From: Sender email address
- To: Recipient email address(es)
- Subject: Email subject line
- Status: Current status (Queued, Accepted, Failed, Discarded)
- Priority: Email priority (High, Medium, Low)
- Attempts: Number of send attempts (e.g., "1/5" = 1 attempt out of 5 max)
- Created: When the email was queued
- Sent: When the email was successfully sent (if applicable)
- Actions: Menu with options (View, Resend, Delete)
Action Menu:
Each email in the queue includes an Actions menu with three options.
- View opens a detailed modal showing the complete email information, including recipients, body content, attachments, and error details (for failed emails).
- Resend allows you to requeue the email—either to the original recipients or to a different address for testing purposes.
- Delete permanently removes the email from the queue, including any associated attachments from the server. This option requires confirmation and cannot be undone.