Email Account

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.

Note: For some services like Gmail, you may need to turn on the settings to allow less secure apps.

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:

  • Use IMAP
  • Use SSL
  • Attachment Limit
  • Default Incoming: If ticked, all replies to your company (eg: will come to this account.
  • Email Sync Option: Whether to sync all or only unseen emails.
  • 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.3 Notification for unreplied messages

If you would like ERPNext to notify you if an email is unreplied for a certain amount of time, then you can set Notify if Unreplied. Here you can set the number of minutes to wait before notifications are sent and whom the notifications must go to.

Incoming EMail

Setting Import Conditions for Email Import

Email Accounts allows you to set conditions according to the data of the incoming emails. The email will be imported to ERPNext only if all conditions are true. For example, if you want to import an email if the subject is "Some important email", you put doc.subject == "Some important email" in the conditions textbox. You can also set more complex conditions by combining them, as shown on the following screenshot.

Incoming EMail Conditions

3.4 Outgoing Email Accounts

All emails sent from the system, either by the user to a 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:

  • Use TLS
  • Port
  • Disable SMTP server authentication
  • Add Signature: The default signature appended to the end of each email.
  • Default Outgoing: Notifications and bulk emails will be sent from this outgoing server.
  • Always use Account's Email Address as Sender: The email address of this account will be mentioned as the sender for outgoing emails.
  • Send unsubscribe message in email: Send a link to unsubscribe from emails sent from this account.
  • 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".
  • Enable Auto Reply: If enabled, enter an auto reply message.
  • Append Outgoing Email to Sent Folder: If using custom email servers like Zimbra or CPanel, SMTP will not automatically append emails to Sent folder. Enabling this option will ensure all emails are explicitly appended to the email account's Sent folder.
  • 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 a 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 it 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 and email account, refer this page.

5. Video

  1. Email Inbox
  2. Email Digest
  3. Auto Email Reports
  4. Sending Email
  5. Email Domain