BeyondERP.Newsletter
Menu

Setup step on the Email distributor batch page · System administration

Keep the email distributor running

Process the server's email queue continuously.

Business process
Administer system features
Menu item
action:SysEmailDistributor
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 periodic job that sends the queued email that the server sends without user interaction.
What you do hereUse this periodic task to process the email queue; it must be running for such email to be sent.
ExampleFor example, after a database refresh BEAT's workflow notifications stop; Batch email sending status shows them queued, and the administrator restarts Email distributor batch with Recurrence set to No end date, every minute.
Email distributor batch 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.

When to run it

When to run itOnce during email setup, and again whenever the job was stopped, deleted or lost after an environment refresh.
How oftenContinuously, as a recurring job with no end date.
Batch settingsKeep it as a recurring batch job with No end date, typically every minute.
What the output showsQueued email such as workflow notifications sent through the batch email provider. Email that stays queued usually means this job isn't running; email that fails usually points to the provider settings or Send As permissions.

Source: Microsoft Learn

Setup steps on this page

Keep the email distributor running

Process the server's email queue continuously.

Steps from Microsoft

  1. Go to System administration > Periodic tasks > Email processing > Email distributor batch.
  2. Before you start it, make sure Email parameters has a batch email provider with working SMTP or Microsoft Graph settings, because this job sends the email that the server sends without user interaction.
  3. Turn on Batch processing; the email queue is processed only while this job runs.
  4. Select Recurrence, select No end date and adjust the count; set it to run every minute if needed.
  5. Start it with the right account: with Microsoft Graph or Exchange, the account that runs the job, usually admin, becomes the sender.
  6. Open Batch email sending status and confirm that queued messages move on to sent.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
Batch processingMust be Yes so the email process keeps running.Microsoft Learn
Run in the backgroundRecurrence with No end date; adjust the count, every minute if needed.Microsoft Learn

Common errors and fixes

MessageWhat to do
Email stays queued in Batch email sending statusThe Email distributor batch isn't running. Turn on Batch processing with a recurrence and no end date. Microsoft Learn
Encryption error occurred with exception (SMTP)The SMTP password was encrypted in another environment. Clear and re-enter it on the SMTP settings tab of Email parameters. Microsoft Learn
(401) Unauthorized or (403) Forbidden when sending with ExchangeThe sender mailbox isn't valid or correctly permissioned in Microsoft 365. Check the Email sender of failed emails on Email history. Microsoft Learn
Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Keep the email distributor runningOne recurring job with No end date, every minute, started by the account that should send Graph or Exchange emailLearn: the batch process must run to process the queue, and with Microsoft Graph or Exchange the account associated with the batch process is the sender.Which account runs the email distributor?Starting the job as a personal admin account; that account becomes the sender of every system email.Test: Queued email is sent

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 companyEnvironment-wide: one recurring job processes the email queue that the server sends without user interaction. Microsoft Learn
Can it be undoneNo: Sent email can't be recalled; stop the job to stop sending.
If you change it laterWith Microsoft Graph or Exchange, the account that runs the batch job, usually admin, is the sender. Microsoft Learn
Technical architect

6Technical

Menu itemaction:SysEmailDistributor Checked in Dynamics 365
FormDialog Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=action:SysEmailDistributor
Data migrationLoad order: Email distributor batch has no data entity in Data management, so it can't be loaded from a file or a configuration template. It is a recurring batch job; start it again in each environment, for example after a refresh.Checked in Dynamics 365
Everyone

8Sources

To cite this step: SA-EMAIL-810, Keep the email distributor running. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SA-EMAIL-810