{"title":"Set up email","url":"https://jonas-paprotka.de/docs/admin-how-setup-email/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/admin-how-setup-email, MicrosoftDocs/dynamics365smb-docs at 46907ac (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/admin-how-setup-email","source":{"name":"Business Central application docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-docs","commit":"46907ace177f8d31deba47a2fdb57c3336e66252","date":"2026-11-19"},"checked":"2026-11-19","description":"Describes how to connect email accounts to Business Central so that you can send outbound messages without having to open another app.","date":"2026-03-12","meta":{"topic":"get-started"},"outline":[{"level":1,"title":"Set up email","slug":"set-up-email","at":0,"chars":20440},{"level":2,"title":"Requirements","slug":"requirements","at":1469,"chars":642},{"level":2,"title":"Add email accounts","slug":"add-email-accounts","at":2111,"chars":2911},{"level":2,"title":"Use SMTP","slug":"use-smtp","at":5022,"chars":1665},{"level":2,"title":"Use the Set Up Email assisted setup guide","slug":"use-the-set-up-email-assisted-setup-guide","at":6687,"chars":545},{"level":2,"title":"Assign email scenarios to email accounts","slug":"assign-email-scenarios-to-email-accounts","at":7232,"chars":1326},{"level":2,"title":"Set up view policies","slug":"set-up-view-policies","at":8558,"chars":1299},{"level":2,"title":"Specify how many messages an account can send per minute","slug":"specify-how-many-messages-an-account-can-send-per-minute","at":9857,"chars":1144},{"level":2,"title":"Set up reusable email texts and layouts","slug":"set-up-reusable-email-texts-and-layouts","at":11001,"chars":2076},{"level":2,"title":"Use a substitute sender address on outbound email messages","slug":"use-a-substitute-sender-address-on-outbound-email-messages","at":13077,"chars":1446},{"level":2,"title":"Set up document sending profiles","slug":"set-up-document-sending-profiles","at":14523,"chars":416},{"level":2,"title":"Optional: Set up email logging in Exchange Online","slug":"optional-set-up-email-logging-in-exchange-online","at":14939,"chars":331},{"level":2,"title":"Optional: Monitor email usage and troubleshoot email failures with telemetry","slug":"optional-monitor-email-usage-and-troubleshoot-email-failures-with-telemetry","at":15270,"chars":529},{"level":2,"title":"Set up email for Business Central on-premises","slug":"set-up-email-for-business-central-on-premises","at":15799,"chars":3921},{"level":3,"title":"Create an app registration for Business Central in Azure portal","slug":"create-an-app-registration-for-business-central-in-azure-portal","at":16499,"chars":2508},{"level":3,"title":"Connect Business Central to your app registration","slug":"connect-business-central-to-your-app-registration","at":19007,"chars":713},{"level":2,"title":"Related information","slug":"related-information","at":19720,"chars":720}],"text":"# Set up email\nPeople in businesses send information and documents, such as sales and purchase orders and invoices, by email every day. Administrators can connect one or more email accounts to Business Central, letting you send documents without having to open an email app. You can compose each message individually with basic formatting tools, such as fonts, styles, colors, and so on, and add attachments of up to 100 MB. Additionally, report layouts enable administrators to include only the key information from documents. See ui-how-send-documents-email.\nEmail in Business Central is only for sending messages, except with AI agents like Sales Order Agent or Payables Agent. For users, there's no inbox page or reply capability inside Business Central. Agents, on the other hand, can monitor and read incoming emails to a specific email account, and then formulate and send replies.\n> NOTE\n> You can use the email capabilities of Business Central online only with Exchange Online. We don't support hybrid scenarios, such as connecting Business Central online to an on-premises version of Exchange.\n> If you're using Business Central on-premises, before you can set up email you must create an app registration for Business Central in the Azure portal. The app registration enables Business Central to authorize and authenticate with your email provider. See #set-up-email-for-business-central-on-premises. In Business Central online, we handle this step for you.\n## Requirements\nThere are a couple of requirements for setting up and using the email features.\n To set up email, you must have the EMAIL - ADMIN permission set. See Assign Permissions to Users and Groups<ui-define-granular-permissions>.\n Everyone who uses the email features must be a fully licensed Business Central. For example, delegated admins and guest users can't use the tenant's email account.\n Everyone who uses the email features must have a valid, paid license for Exchange Online. Otherwise, they can't use some features. For example, they can't send emails because Exchange rejects their messages. You can't use trial licenses.\n## Add email accounts\nYou add email accounts through extensions that enable accounts from different providers to connect to Business Central. The standard extensions let you use accounts from Microsoft Exchange Online. However, other extensions that let you connect accounts from other providers, such as Gmail, might be available.\nYou can specify predefined business scenarios in which to use an email account to send emails. For example, you can specify that all users send sales documents from one account, and purchase documents from another. See #assign-email-scenarios-to-email-accounts.\nThe following table describes the email extensions that are available by default.\nExtension|Description|Examples of when to use\nMicrosoft 365 Connector|Everyone sends email from a shared mailbox in Exchange Online.|When all messages come from the same department, for example, your sales organization sends messages from a sales@cronus.com account. This option requires that you set up a shared mailbox in the Microsoft 365 admin center. See https://learn.microsoft.com/Exchange/collaboration/shared-mailboxes/shared-mailboxes.\nCurrent User Connector|Everyone sends email from the account they used to sign in to Business Central.|Allow communications from individual accounts.\nSMTP Connector|Use Simple Mail Transfer Protocol (SMTP) protocol to send emails.|Allow communications through your SMTP mail server.\nThe Microsoft 365 Connector and Current User Connector extensions use the accounts you set up for users in the Microsoft 365 admin center for your Microsoft 365 subscription. To send email using the extensions, users must have a valid license for Exchange Online. Additionally, in sandbox environments, these extensions, including the Outlook REST API extension, require that the Allow HttpClient Requests setting is enabled. To check whether the setting is enabled for these extensions, go to the Extension Management page, choose the extension, and then choose the Configure option.\nExternal users, such as delegated admins and external accountants, can't use these extensions to send email messages from Business Central.\n> NOTE\n> If you're using service-to-service (S2S) authentication, the Microsoft 365 and Current user connectors can't authenticate the user when they send a sales or purchase document by email. When someone sends a document, the following error message displays:\n> \"You aren't authorized to access this resource: https:\\//graph.microsoft.com/.default. Contact your system administrator.\"\n> The bound actions on the document APIs that send email cause the problem. To learn more about the bound actions, go to dev-itpro/api-reference/v2.0/resources/dynamics_salesinvoice#bound-actions.\n> If you want to use S2S authentication and the email features, use the SMTP connector option.\n<br><br>\n> Video<https://learn-video.azurefd.net/vod/player?id=a18f480a-f0d5-4248-8acb-ec667a7f53e1>\n## Use SMTP\nIf you want to use SMTP protocol to send emails from Business Central, you can use the SMTP Connector extension. When you set up an account that uses SMTP, the Sender Type field is important. If you choose Specific User, emails are sent using the name and other information from the account you're setting up. However, if you choose Current User, emails are sent from the email account specified for each user's account. Current User is similar to the Send As feature. See #use-a-substitute-sender-address-on-outbound-email-messages.\n> IMPORTANT\n> To use OAuth 2.0 for SMTP authentication, consider the following:\n > All users must be on the same Microsoft Entra tenant.\n > For Business Central on-premises, you must create an application registration in the Azure portal, and then run the Set up Microsoft Entra ID assisted setup guide in Business Central to connect to Microsoft Entra ID. See #create-an-app-registration-for-business-central-in-azure-portal.\n> Exchange Online is deprecating use of Basic authentication for SMTP. This change doesn't affect tenants that are currently using SMTP AUTH. However, we strongly recommend using the latest version of Business Central and setting up OAuth 2.0 authentication for SMTP. We currently don't support certificate-based authentication. If you can't set up OAuth 2.0 authentication, we encourage you to explore non-Microsoft alternatives if you want to use SMTP email in earlier versions.\n> NOTE\n> When you copy a company that's using an SMTP email account to send emails, the password for the account isn't included. You'll need to re-enter the password on the SMTP Account page in the new company.\n## Use the Set Up Email assisted setup guide\nThe Set Up Email assisted setup guide can help you get started quickly with emails.\n> NOTE\n> You must have a default email account, even if you add only one account. The default account is used for all email scenarios that aren't assigned to an account. See #assign-email-scenarios-to-email-accounts.\n1. Select Search (Alt+Q) in the upper-right corner, enter Set Up Email Accounts, and then choose the related link.\n2. Fill in the fields as necessary. Hover over a field to read a short description.\n## Assign email scenarios to email accounts\nEmail scenarios are processes that involve sending a document. For example, a sales or purchase order or a notification, such as an invitation to an external accountant. Specific email accounts can be used for specific scenarios. For example, you can specify that all users always send sales documents from one account, purchase documents from another, and warehouse or production documents from a third account. You can assign, reassign, and remove scenarios whenever you want. A scenario can only be assigned to one email account at a time. The default email account is used for all scenarios that aren't assigned to an account.\nOn the Email Scenario Assignment page, you can choose the Set Default Attachments action to add attachments to email scenarios. The attachments are always available when you compose an email for a document related to the scenario. Each email scenario can have one or more default attachments. Default attachments are automatically added to emails for the email scenario. For example, when you send a sales order by email, the default attachment specified for the Sales Order scenario is added. Default attachments display in the Attachments section at the bottom of the Compose an Email page. You can manually add nondefault attachments to the email.\n## Set up view policies\nYou can control the email messages that a user can access in the Email Outbox and Sent Emails pages.\nOn the User Email View Policies, choose a user, and then choose one of the following options in the Email View Policy field:\n View own emails - The user can view only their own email messages.\n View all emails - The user can view all email messages, including emails that were sent by other users.\n View if access to all related records - This view policy is used if no other policy is specified. A user can view email messages that other users sent if the user has access to the record that was sent and all of the related records. For example, User A sent a posted sales invoice to a customer. User B can access the email message if they have access to both the invoice and the customer.\n View if access to any related records - The user can view email messages that were sent by other people if the user has access to at least one record that is related to the record that was sent. For example, User A sent a posted sales invoice to a customer. User B can access the email message if they have access to either the invoice or the customer.\n> NOTE\n> If you leave the User ID field empty and then choose the Email View Policy action, the view policy applies to all users.\n## Specify how many messages an account can send per minute\nSome email providers (ISPs) limit the number of email messages an email account can send in one go, or within a certain amount of time, or both. This practice, known as email throttling, helps ISPs control traffic on their servers and prevent spam. If an email account exceeds the limit, the ISP might block the messages. To ensure that the number of messages that you send from Business Central complies with your ISP's limit, specify the limit for each of your email accounts.\nThe default limit for the Microsoft 365 and Current User account types is 30, which matches the limit set by Exchange Online.\nThere are a few ways to specify the limit:\n When you use the Set Up Email assisted setup guide to create a new account, specify the limit in the Rate limit per minute field.\n For existing email accounts, specify:\n   The number of messages an account can send per minute in the Email rate limit field on the account.\n   The maximum number of messages an account can send simultaneously in the Email Concurrency Limit field. By default, the limit is 3, but you can allow up to 10.\n## Set up reusable email texts and layouts\nYou can use reports to include key information from sales, purchase, and service documents in texts for emails. Report layouts define the style and the content of the text in the email. For example, the content might include texts such as a greeting or instructions that precede the document information. This procedure describes how to set up the Sales - Invoice report for posted sales invoices, but the process is similar for other reports.\n> NOTE\n> To use the layout to create content for email messages, you must use the Word file type for your layout.\n1. Select Search (Alt+Q) in the upper-right corner, enter Report Selections - Sales, and then choose the related link.\n1. On the Report Selection - Sales page, in the Usage field, select Invoice.\n1. On a new line, in the Report ID field, select, for example, standard report 1306.\n1. Select the Use for Email Body checkbox.\n1. Choose the Email Body Layout Description field, and then select a layout from the list.\n1. To view or edit the layout that the email text is based on, select the layout on the Custom Report Layouts page, and then choose the Export Layout action. If you customize the layout, use the Import Layout action to upload the new layout.\n> NOTE\n> To customize a standard report layout, such as 1306, you must make a copy of the report. Business Central helps you create a copy when you import a custom layout for a standard report. The name of your new custom report layout is prefixed with \"Copy of.\"\n1. If you want to let customers use a payment service, such as PayPal, you have to set up the service. Afterward, the PayPal information and link are inserted in the email text. See Enable Customer Payments Through PayPal<sales-how-enable-payment-service-extensions>.\n1. Choose the OK button.\nNow, for example, when you choose the Send action on the Posted Sales Invoice page, the email body contains the document information of report 1306. The information is preceded by styled standard text according to the report layout that you selected in step 5.\n## Use a substitute sender address on outbound email messages\nIf you're using the SMTP Connector extension, you can use the Send As or Send on Behalf capabilities from Microsoft Exchange to change the sender address on outbound messages. Business Central uses the SMTP account to authenticate to Exchange, but either replaces the sender address with the one you specify, or amends it with \"on behalf of.\"\nWhen you set up an account and you want to use the Send As or Send on Behalf capabilities from Exchange, in the Sender Type field, choose Specific User.\nAlternatively, you can choose Current User to allow people to send messages through the SMTP Connector. The message appears to be sent from the email account specified in the Contact Email field on the User Card for the user they're signed in as. However, it functions similar to the Send As feature and is sent from the account specified in the setup of the SMTP Connector.\nThe following are examples of how Send As and Send on Behalf are used in Business Central:\n You might want the purchase or sales orders that you send to vendors and customers to appear to come from a _noreply@yourcompanyname.com_ address.\n When your workflow sends an approval request by email using the email address of the requester.\n> NOTE\n> You can only use one account for substitute sender addresses. That is, you can't have one substitute address for purchasing processes, and another for sales processes.\n## Set up document sending profiles\nYou can save time by setting up a preferred method of sending sales documents for each of your customers. Setting a preferred method means you don't have to select a sending option every time you send a document. For example, such as whether to send the document by email or as an electronic document. See Set Up Document Sending Profiles<sales-how-setup-document-send-profiles>.\n## Optional: Set up email logging in Exchange Online\nGet more out of the communications between salespeople and your existing or potential customers. You can track email exchanges, and then turn them into actionable opportunities. See Track Email Message Exchanges Between Salespeople and Contacts<marketing-set-up-email-logging>.\n## Optional: Monitor email usage and troubleshoot email failures with telemetry\nAdministrators can switch on the telemetry feature in Business Central to get data about usage and failures of different capabilities. For email, we log the following operations:\n An email was sent successfully\n An attempt to send an email failed\n Authentication to an SMTP server succeeded/failed\n Connection to an SMTP server succeeded/failed\nSee Analyzing Email Telemetry (administration content)<dev-itpro/administration/telemetry-email-trace>.\n## Set up email for Business Central on-premises\nBusiness Central on-premises can integrate with services that are based on Microsoft Azure. For example, you can use Cortana Intelligence for smarter cash flow forecasts, Power BI to visualize your business, and Exchange Online for sending email. Integration with these services is based on an app registration in Microsoft Entra ID. The app registration provides authentication and authorization services for communications. To use the email capabilities in Business Central on-premises, you must register Business Central as an app in the Azure portal, and then connect Business Central to the app registration. The following sections describe how.\n### Create an app registration for Business Central in Azure portal\nThe steps to register Business Central in Azure portal are described in Register an application in Microsoft Entra ID<dev-itpro/administration/register-app-azure#register-an-application-in-azure-active-directory>.\n> NOTE\n> To use the email features, your app registration must use a multitenant configuration.\nThe settings that are specific to the email capabilities are the delegated permissions that you grant to your app registration. The following table lists the minimum permissions.\nAPI / Permission Name|Type|Description\nMicrosoft Graph/User.Read|Delegated|Sign in and read user profile.\nMicrosoft Graph/Mail.ReadWrite|Delegated|Compose email messages.\nMicrosoft Graph/Mail.Send|Delegated|Send email messages.\nMicrosoft Graph/offline_access|Delegated|Maintain data access consent.\nMicrosoft Graph/Mail.Send.Shared|Delegated|Shared Mailbox\nIf you're using the SMTP Connector and want to use OAuth 2.0 for authentication, the permissions are slightly different. The following table lists the permissions.\nAPI / Permission Name|Type|Description\nMicrosoft Graph/offline_access|Delegated|Maintain data access consent.\nMicrosoft Graph/openid|Delegated|Sign users in.\nMicrosoft Graph/User.Read|Delegated|Sign in and read user profile.\nMicrosoft Graph/SMTP.Send|Delegated|Send emails from mailboxes using SMTP AUTH.\nOffice 365 Exchange Online/User.Read|Delegated|Sign in and read user profile.\nWhen you create your app registration, note the following information. You use it to connect Business Central to your app registration.\n Application (client) ID\n Redirect URI (optional)\n Client secret\nLearn more about general guidelines for registering an app at Quickstart: Register an application with the Microsoft identity platform<https://learn.microsoft.com/azure/active-directory/develop/quickstart-register-app>.\n> NOTE\nIf you have trouble using the SMTP protocol to send email after you connect Business Central to your app registration, it might be because SMTP AUTH isn't enabled for your tenant. We recommend that you use the Microsoft 365 and Current User email connectors instead, because they use Microsoft Graph Mail APIs. However, if you must use SMTP protocol you can enable SMTP AUTH. See Enable or disable authenticated client SMTP submission (SMTP AUTH) in Exchange Online<https://learn.microsoft.com/exchange/clients-and-mobile-in-exchange-online/authenticated-client-smtp-submission#disable-smtp-auth-in-your-organization>.\n### Connect Business Central to your app registration\nAfter you register your application in Azure portal, in Business Central, use the Email Microsoft Entra application registration page to connect Business Central to it.\n1. In Business Central, select Search (Alt+Q) in the upper-right corner, enter Email Microsoft Entra application registration, and then choose the related link.\n2. Fill in the fields as necessary. Hover over a field to read a short description.\n> TIP\n> Alternatively, if you're connecting for the first time, you can run the Set up email assisted setup guide. In this case, the guide includes the Email Microsoft Entra application registration page for connecting to your app registration.\n## Related information\nShared mailboxes in Exchange Online<https://learn.microsoft.com/exchange/collaboration-exo/shared-mailboxes>\nWork with Business Central<ui-work-product>\nSetting Up Business Central<setup>\nui-how-send-documents-email\nCustomizing Business Central Using Extensions<ui-extensions>\nUse Business Central as Your Business Inbox in Outlook<admin-outlook>\nGetting Business Central on My Mobile Device<install-mobile-app>\nGetting Business Central on My Mobile Device<install-mobile-app>\nAnalyzing Email Telemetry (administration content)<dev-itpro/administration/telemetry-email-trace>\nFind free e-learning modules for Business Central here<https://learn.microsoft.com/training/dynamics365/business-central>"}