BeyondERP.Newsletter
Menu

Inquiry page · System administration

Email history

An inquiry page where administrators review all sent emails and any errors that stopped an email from being sent.

Business process
Administer system features
Menu item
SysEmailHistory
Main table
SysEmailHistory
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isAn inquiry page where administrators review all sent emails and any errors that stopped an email from being sent.
What you do hereUse this page to troubleshoot failed emails by reading the error on each failed email.
ExampleFor example, when Exchange returns an Unauthorized error, filter the page for Failed emails and note the Email sender to find the user whose mailbox has the problem.
Email history page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processAdminister system features
Menu pathSystem administration › Setup › Email › Email history
Set up firstEmail parameters Microsoft Learn
Used next byBatch email sending status Microsoft Learn
Related pagesRetry schedule Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Review Email history

Use this inquiry to find failed emails and the reason they failed.

Steps from Microsoft

  1. Go to System administration > Setup > Email > Email history.
  2. Add a filter for Failed emails to the Email status field.
  3. Select a failed email and read the error on the Failure details tab.
  4. Note the Email sender value to find the affected user.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Email statusShows whether an email was sent or Failed.Microsoft Learn Status
Email senderThe user the email was sent as.Microsoft Learn Sender

Common errors and fixes

MessageWhat to do
Failed emails show an Unauthorized error from ExchangeFilter on Failed, note the Email sender and check that user's mailbox and its permission to send. Microsoft Learn

Test checklist

  1. Send a test email from Email parameters.
  2. Open Email history and filter Email status on Failed.
  3. Select a failed email and read Failure details.
  4. Note the Email sender and fix that mailbox or account.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Review Email historyFilter Email status on Failed first, then read Failure details and the Email senderThe failure details hold the error that stopped the email, and the sender points to the user whose mailbox has the problem.How long should email history be kept?Looking for emails older than the retention period: history is kept 30 days by default (Number of days to retain email history on Email parameters).Test: A failed email can be traced

Feature management and licence

Licence or add-inNo Feature management feature needs to be turned on for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: the same records are used by every legal entity. Microsoft data model
Can it be undoneReversible: Reading the history changes no data; entries older than the retention period are removed automatically. Microsoft Learn
If you change it laterEmail history is kept for 30 days by default; change Number of days to retain email history on the Email parameters page. Microsoft Learn
Technical architect

6Technical

Menu itemSysEmailHistory Checked in Dynamics 365
FormSysEmailHistory Checked in Dynamics 365
TableSysEmailHistoryShown as “Email history” in Record infoChecked in Dynamics 365
Who can open itPrivilegesGrants access to view email history SysEmailHistoryChecked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=SysEmailHistory
Data migrationLoad order: Email history has no data entity in Data management, so it can't be loaded from a file or a configuration template. The history is written by the system as email is sent and isn't moved between environments.Checked in Dynamics 365
Table definitionSysEmailHistory columns and relations Microsoft data model
Everyone

8Sources