You can sync your email account with ERPNext to send and receive emails from ERPNext.

You can manage multiple incoming and outgoing Email Accounts in ERPNext. There has to be at least one default outgoing account and one default incoming account. If you are on the ERPNext cloud, the default outgoing email is set by us.

To access Email Accounts, go to:

> Home > Settings > Email Account

1. Prerequisites

Before creating an Email Account, you need an Email Domain. However, you can skip creating an Email Domain if you're using one of the services listed here.

2. How to create an Email Account

  1. Go to the Email Account list, click on New.

  2. Enter the email address with the domain. Domains need to be created in order to create an email account. You don't need to create a domain if you're syncing an email from certain providers as listed here.

  3. Enter the email account password.

  4. Save. If the credentials are correct, the email account will be synced.

For some services like Gmail, you may need to enable 2FA and use App Passwords.

2.1 Additional options when creating an Email Account

  1. Use Different Email Login ID: To use an alternative email login and password to access this account. For example, if you have and you want users to access this email with an alternate email ID, they should tick this checkbox. The recipients will see as the sender.

  2. Awaiting password: If you're creating this account on behalf of someone and the password is unknown, tick this checkbox. When the other user logs in, they'll be prompted to enter the password.

  3. Use ASCII encoding for password: Ticking this will use ASCII encoding for the password.

3. Configuration of the Email Account

3.1 Default Email Accounts

ERPNext will create templates for a bunch of email accounts by default. Not all of them are enabled. To enable them, you must set valid email account details.

There are two types of email accounts, outgoing and incoming. Outgoing email accounts use an SMTP service to send emails and emails are retrieved from your inbox using an IMAP or POP. Most email providers such as Gmail, Outlook, or Yahoo provide these services.

Defining Criteria

3.2 Incoming Email Accounts

To set up an incoming Email Account, check on Enable Incoming and set your POP3 settings, if you are using a popular email service, these will be preset for you.

Incoming EMail

The following options are available for incoming emails:

  1. Use IMAP

  2. Use SSL

  3. Attachment Limit

  4. Default Incoming: If ticked, all replies to your company (eg: will come to this account.

  5. Email Sync Option: Whether to sync all or only unseen emails.

  6. Initial Sync Count: Number of emails to sync the first time.

Appending Emails To Documents

This feature creates documents when an email is sent to a particular email account. For example, you can append to the Issue DocType. On doing this, whenever an email is sent to, the system will create an Issue for it. Similarly, if you link, when emails are sent to, a Job Applicant document is created.

Enable Automatic Linking in Documents will link emails to documents, to know more click here.

3.4 Outgoing Email Accounts

All emails sent from the system, either by the user to contact or via notifications or via transaction emails, will be sent from an Outgoing Email Account.

To set up an outgoing Email Account, check on Enable Outgoing and set your SMTP server settings, if you are using a popular email service, these will be preset for you.

Outgoing EMail

The following options are available for outgoing emails:

  1. Use TLS

  2. Port

  3. Disable SMTP server authentication

  4. Add Signature: The default signature is appended to the end of each email.

  5. Default Outgoing: Notifications and bulk emails will be sent from this outgoing server.

  6. Always use Account's Email Address as Sender: The email address of this account will be mentioned as the sender for outgoing emails.

  7. Send unsubscribe message in an email: Send a link to unsubscribe from emails sent from this account.

  8. Track Email Status: Track if your email has been opened by the recipient. Note that, if you're sending to multiple recipients, even if one recipient reads the email, it'll be considered "Opened".

  9. Enable Auto Reply: If enabled, enter an auto-reply message.

  10. Append Outgoing Email to Sent Folder: If using custom email servers like Zimbra or CPanel, SMTP will not automatically append emails to the Sent folder. Enabling this option will ensure all emails are explicitly appended to the email account's Sent folder.

  11. Use SSL for Outgoing Emails: Use SSL as a standard for outgoing emails. Defaults to port 465.

4. How ERPNext handles replies

In ERPNext when you send an email to contact like a customer, the sender will be the user who sent the email. In the Reply-To property, the Email Address will be of the default incoming account (like []( ERPNext will automatically extract these emails from the incoming account and tag them to the relevant communication.

> Note for self implementers: For outgoing emails, you should set up your own SMTP server or sign up with an SMTP relay service like or that allows a larger number of transactional emails to be sent. Regular email services like Gmail will restrict you to a limited number of emails per day.

If you encounter errors when configuring an email account, refer to this page.

5. Video

6. Related Topics

  1. Email Inbox

  2. Email Digest

  3. Auto Email Reports

  4. Sending Email

  5. Email Domain

Was this article helpful?