BeyondERP.Newsletter
Menu

Setup step on the Email parameters page · System administration

Set up Email parameters

Use this page to configure email behavior for the environment and to send a test email.

Used by
Information technology manager
Business process
Administer system features
Menu item
SysEmailParameters
Main table
SysEmailParameters
Data entity
SysEmailParametersEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where administrators set how email is sent for the whole environment, including the email providers and the SMTP or Microsoft Graph settings.
What you do hereUse this page to configure email behavior for the environment and to send a test email.
ExampleFor example, BEAT sends collection letters and workflow notifications through Microsoft Graph: the app registration has the Mail.Send application permission with admin consent, and the per-minute email sending limit stays 0 because Graph has its own throttling.
Email parameters 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

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.

Step by step, with screenshots

Set up Email parameters1 screen

Use this page to configure email behavior for the environment and to send a test email.

  1. Screen 1

    Review the email parameters

    Go to System administration > Setup > Email > Email parameters

    1. Open the Configuration tab and review the batch email provider, the attachment size limit and the email expiration
    2. Review which interactive email providers are enabled
    3. Open the SMTP settings or Microsoft Graph settings tab to review the provider settings
    4. Open the Test email tab to send a test email
    Review the email parameters (zoomed on the outlined fields)
    Show the full screenReview the email parameters
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to System administration > Setup > Email > Email parameters.
  2. On the Configuration tab, choose the interactive and batch email providers: Microsoft Graph for Microsoft 365 customers, SMTP otherwise. The Exchange provider is deprecated.
  3. For Microsoft Graph or Exchange, keep the per-minute email sending limit at 0.
  4. On the Microsoft Graph settings tab, enter the Application ID and the Application secret of the app registered in Microsoft Entra ID.
  5. For SMTP, on the SMTP settings tab, enter the outgoing mail server, port 587 and SSL required = Yes, and the account if authentication is required.
  6. Select Save, and then send a test email.
  7. Turn on Batch processing for the Email distributor batch so queued email is sent.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Batch email providerThe provider used for email sent by batch or non-interactive processes.Microsoft Learn MailerNonInteractive
Attachment size limitThe largest single email that can be sent.Microsoft Learn
Email expiration in daysDays before an unsent email is set to Expired; 0 means the 30-day default.Microsoft Learn ExpirationInDays
Number of days to retain email historyHow long email history is kept; 0 means the 30-day default.Microsoft Learn NumDaysToRetainHistory
per-minute email sending limitCaps how many emails a non-interactive provider sends per minute; 0 removes the cap.Microsoft Learn
Outgoing mail serverThe host name of the SMTP server.Microsoft Learn SMTPRelayServerName
SMTP port numberThe SMTP port, usually 587 for secure transport.Microsoft Learn SMTPPortNumber
SSL requiredWhether secure transport is used.Microsoft Learn
Authentication requiredWhether a user name and password are needed to send email.Microsoft Learn

Common errors and fixes

MessageWhat to do
Microsoft.Dynamics.Ax.Xpp.Security.CryptoEncryptionException: Encryption error occurred with exceptionClear and re-enter the SMTP password on the SMTP settings tab (typical after a database copy between environments). Microsoft Learn
If your SMTP server doesn't support authentication, please clear the SMTP user name and passwordClear the User name and Password fields on the SMTP settings tab. Microsoft Learn
Client does not have permissions to send as this senderGive the sending accounts Send As permission on the SMTP account. Microsoft Learn

Test checklist

  1. Set the Batch email provider and save; select Test email.
  2. Turn on Batch processing for the Email distributor batch.
  3. Send a customer statement by email from Collections.
  4. Check Batch email sending status and Email history show the email as sent, not Failed.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Email parametersMicrosoft Graph as Batch email provider (with per-minute email sending limit = 0); if SMTP is used: port 587 with SSL required = YesMicrosoft Graph is the recommended provider for Microsoft 365 customers and replaces the deprecated Exchange provider. Graph and Exchange have their own throttling, so their per-minute limit should be 0.Which email provider should send email?Relying on SMTP with an account that has multifactor authentication: SMTP in finance and operations doesn't support MFA or OAuth 2.0, so emails fail to authenticate.Test: Batch email is delivered through the configured provider
Solution architect

5Design impact

Shared or per companyShared: the same records are used by every legal entity. Microsoft data model
Can it be undoneReversible: Providers and settings can be changed at any time. The SMTP password is encrypted per environment and must be re-entered after a database copy.
If you change it laterSMTP in finance and operations doesn't support multifactor authentication or OAuth 2.0, and the deprecation of Basic authentication in Exchange Online affects SMTP through Microsoft 365 SMTP servers, so Microsoft recommends the Microsoft Graph provider. The SMTP password is encrypted per environment and must be cleared and re-entered after a database copy. Microsoft Learn
Technical architect

6Technical

Menu itemSysEmailParameters Checked in Dynamics 365
FormSysEmailParameters Checked in Dynamics 365
TableSysEmailParametersShown as “Email parameters” in Record infoChecked in Dynamics 365
Data entitiesSysEmailParametersEntityEmail parameters Microsoft data model
Who can open itPrivilegesMaintain email parameters SysEmailParametersMaintainView email parameters SysEmailParametersViewDutiesMaintain system settings SysServerSettingsMaintain
1 security roleInformation technology manager SysServerITManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itInformation technology manager SysServerITManagerGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, Edit, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=SysEmailParameters
Integrate withSysEmailParametersEntity data entity Microsoft data model
Data migrationSysEmailParametersEntity (Email parameters): shared by all companies.Load order: Email parameters isn't in Microsoft's default configuration templates in BEAT; add it to a data project on its own. A database refresh doesn't copy the SMTP relay server to the target sandbox, and the SMTP password must be entered again there.Checked in Dynamics 365
Table definitionSysEmailParameters columns and relations Microsoft data model
Everyone

8Sources

To cite this step: SA-SETUP-340, Set up Email parameters. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SA-SETUP-340