Category: Business CentralRead time: 5 MinsPublished on: 02 Mar 2026

How to Set Up Gmail SMTP Email in Microsoft Dynamics 365 Business Central

  1. Home
  2. Blog
  3. Setting up Gmail SMTP email in Business Central

In this step-by-step guide, you will learn how to configure Gmail SMTP in Microsoft Dynamics 365 Business Central using a Google app-specific password. Proper email configuration is essential for sending sales confirmations, invoices, and automated notifications directly from your ERP system. If you need expert help with configuration, authentication setup, or email workflow automation, explore our Dynamics 365 Business Central consulting services to ensure secure and reliable email integration.

We cover everything from enabling 2-Step Verification in Google, generating a 16-character app password, configuring SMTP settings in Business Central (smtp.gmail.com, Port 587, Basic Authentication), setting up email scenarios for Sales Order confirmations, and verifying delivery through the Sent Emails log. This guide applies to Business Central 2024 Wave 2 and later versions.

To configure a Gmail account for sending emails from Business Central, you need to set up an SMTP account with your Gmail credentials in Business Central. The key difference in this process is the requirement to register the application with Google and generate an app-specific password. This app password will be used to authenticate the Gmail account in Business Central.

The steps outlined below are applicable to Microsoft Dynamics 365 Business Central 2024 Wave 1 and Wave 2 (versions 24 and 25), though the process remains largely consistent across recent versions.

1. Steps for setting up SMTP mail using Gmail in Business Central

Before starting the configuration, keep the following Gmail SMTP settings ready for Business Central:

Setting Value
Server URL smtp.gmail.com
Server Port 587
Authentication Basic
Encryption STARTTLS
App Password Required Yes (16-character Google App Password)
2-Step Verification Must be enabled on Google Account
  1. Register the app in Google

    STEP 1: Sign-in to the desired Google account and open the Security tab.

    A screenshot of the Google Account settings page. On the left-hand navigation sidebar, the 'Security' tab is highlighted with a prominent red rectangular box. The main content area displays sections for 'Privacy suggestions' and a search bar labeled 'Search Google Account.'

    STEP 2: To register an app in Google, it requires 2-Step Verification to be enabled. Enable 2-Step Verification under the Security tab.

    A screenshot of the Google Account 'Security' page. Under the 'How you sign in to Google' section, the '2-Step Verification' row is highlighted with a red rectangular box, showing a green checkmark.

    STEP 3: After configuring 2-Step Verification we can see App passwords at the bottom of the page. App passwords let you sign in to the Google account from the apps on devices.

    A screenshot of 2-step verification screen in Business Central security page showing App passwords settings, indicating 1 password is currently active.

    STEP 4: Under the App passwords section, select “Other (Custom name)” from the drop-down list and click on “Generate” to see the password.

    A screenshot of the 'App passwords' interface. A red rectangular box highlights the selection area where a user can choose an app and device to generate a password.

    A 16-character password will be generated that can be used in Business Central when configuring the SMTP account.

    A screenshot titled 'Generated app password'. The interface displays a unique 16-character security key highlighted in a yellow box, alongside instructions on how to apply the code to a specific application or device.
  2. Configure SMTP in Business Central

    To start configuring SMTP in Business Central, follow the below steps:

    STEP 1: Search for “Set Up Email” in Business Central. On the pop-up wizard click Next.

    STEP 2: In the new screen, select SMTP and click Next.

    A screenshot of the 'Set Up Email' wizard within a business application interface. The 'SMTP' account type is selected and highlighted in light blue, with the description 'Use SMTP to send emails' visible.

    STEP 3: In the Setup SMTP Account page provides an Account Name, Gmail address, Sender Type and Sender Name.

    STEP 4: Provide the details below and Gmail password generated in the Google account

    Server Url: smtp.gmail.com

    Server Port: 587

    Authentication: Basic

    A screenshot of the 'Setup SMTP Account' screen. Red rectangular boxes highlight the critical server configuration fields and the Password field contains an encrypted string.
  3. Configure Mail Account for Operations

    We can see the configured mail accounts in the Email Accounts page. To use an email account for specific scenarios, go to Navigate -> Email Scenarios

    A screenshot of the 'Email Accounts' navigation bar. A red rectangular box highlights the 'Email Scenarios' option, which allows users to assign specific email accounts to different business processes or scenarios.

    For example, select Sales Order to send order confirmation emails using this account.

    A screenshot of the 'Email Scenario Assignment' window. The 'Sales Order' scenario is selected and highlighted in light blue, indicating it is being assigned to the specific email account.

    In the Sales Order page, use “Email Confirmation” to send the order confirmation to the Customer.

    A screenshot of a 'Email Confirmation' record highlighted in a red rectangular box.

    You can edit the email content or address in the compose mail window.

    A screenshot of a 'Sales Order' record for 'The Cannon Group PLC'. Within the 'Print/Send' menu, a red rectangular box highlights the 'Email Confirmation...' action, used to trigger the delivery of the order via the configured SMTP account.

    Check the Sent Emails page, to confirm the mail has been delivered successfully.

    A screenshot of the 'Sent Emails' log within Business Central. It displays successfully sent items, confirming the SMTP integration is fully operational.

2. Troubleshooting Common Gmail SMTP Issues in Business Central

If your Gmail SMTP setup is not working as expected in Business Central, here are the most common issues and fixes:

Issue 1: Authentication Failed

This usually occurs when you use your regular Gmail password instead of the app-specific password. Make sure you are using the 16-character app password generated in your Google account, not your standard login password.

Issue 2: 2-Step Verification Not Enabled

Google does not allow app passwords unless 2-Step Verification is active on your account. Go to your Google Account → Security → 2-Step Verification and it is enabled before generating an app password.

Issue 3: SMTP Connection Error on Port 587

Ensure the Server URL is set to smtp.gmail.com and the port is 587. Using port 465 or 25 may cause connection failures in Business Central.

Issue 4: Email Not Appearing in Sent Emails Page

If the email was composed and sent but does not appear in the Sent Emails log in Business Central, check whether the correct email scenario was assigned to the account under Navigate → Email Scenarios.

Issue 5: App Password Option Not Visible in Google Account

If you cannot see the App Passwords Option under Security, it means 2-Step Verification is either not enabled or was recently disabled. Re-enable it and refresh the page.

3. FAQs