Skip to content

IMAP and SMTP configuration

In this article:

IMAP configuration


You need to have cron properly configured in your system to have inbound emails working.

IMAP allows to retrieve your emails from an email client. To setup the IMAP account, do the following steps: 1. Select Emails Tab > top-right menu > Personal Email Accounts. 2. Click on Create Personal Email Account. 3. In the Main section, specify your Email Address. The Name of personal email account is generated automatically, but you may change it. Fetch since allows to choose the date from which emails should be archived. In case you want to archive old emails, set it to some prior date to the day from which they should be fetched.

Create personal email account

  1. In the IMAP section, enter your Host name, your Email Client Username and Email Client Password in the fields shown. Tick of SLL for a secure connection. The IMAP Port will be generated automatically.

IMAP configuration

  1. Specify what folders to monitor in Monitored Folders field. By default, it is set to INBOX. If you use some external email client to send emails, you can add Sent folder to archive those emails.
  2. Put in Folder field allows to specify the folder in which the incoming emails will be put.
  3. Click on Test Connection to check whether everything was specified correctly. If a connection is successful, click Save on the top of the page.

SMTP configuration

SMTP allows to send email messages out. Users can setup SMTP settings in Preferences as well as in their Personal Email Accounts. An administrator can also allow to use System SMTP (make it shared).

Users can have multiple SMTP accounts. However, email addresses a user can use to send emails from are defined by email addresses of User record.

To setup SMTP account, do the following:

  1. Navigate either to Personal Email Accounts page (Emails Tab > top-right menu > Personal Email Accounts) or to Preferences > SMTP settings.
  2. Tick off Use SMTP box.
  3. Enter your SMTP Host name, in SMTP security field select TLS for a secure connection. A proper SMTP Port will be set automatically.
  4. Tick SMTP Auth box and enter your Email Client Username and Email Client Password in the fields shown.
  5. Click on Send Test Email to check whether everything was specified correctly. If the connection is successful, you will receive test email on the specified email address.

SMTP configuration

Google Workspace

  1. Sign into your Google Admin console.
  2. Navigate to App > G Suite > Gmail > Advanced settings.
  3. Select the organizational unit in the organizations section.
  4. Under the POP and IMAP Access, uncheck the Disable POP and IMAP access for all users box checkbox.
  5. Each user has to enable IMAP access as described for Gmail Account.


  1. Sign into your Gmail Account.
  2. Select Settings > Settings.
  3. Click the Forwarding and POP/IMAP tab.
  4. In the IMAP access, select Enable IMAP.
  5. Click on Save Changes.


There are two ways in which you can setup IMAP and SMTP for Gmail account:

  • Use the Google Integration extension that provides a secure authentication via Oauth2.
  • Use a generated App Password. Requires enabling 2-step verification for your Google account.

For more information, follow the link.


  1. Go to your Outlook Account.
  2. Select Settings > View all Outlook settings.
  3. On the navigation panel, select Mail > Sync email.
  4. Click Yes to enable POP and IMAP access.
  5. Press Save button on the top of the page.

Important: The TLS encryption method may not work for IMAP, use the SSL method in this case.

Outlook configuration


If you have 2FA enabled for your Microsoft account, you need to create app password and use it in Espo instead of your main password. More info here.


Configuration details are available here.

App passwords

For security reasons it's not recommended to use account passwords when connecting to services like email. That's why major services provides the ability to generate a different password that will be used only in a specific application for a single purpose.

See the articles for the service you use: