WebMail Pro documentation

How to connect to Gmail

Gmail requires establishing secure connections (SSL/TLS). WebMail Pro supports SSL/TLS and can connect to Gmail. And starting from v8.7, OAuth is supported, in addition to username/password authentication.

NB: OAuth is currrently supported only for those Gmail accounts you add to your main account with "Add New Account" button in Email Accounts settings screen.

To allow for logging into Gmail accounts or adding those to an existing account, add a new mail server in admin area, specify gmail.com domain for it, and make sure the following mail server details are supplied:

  • Incoming mail: imap.gmail.com
      Port 993
      Use SSL
  • Outgoing mail: smtp.gmail.com
      Port 465
      Use SSL

You also need to make sure IMAP access is allowed in your Gmail account configuration, see "Forwarding and POP/IMAP" section of account settings.

Starting from v8.7, WebMail Pro supports OAuth. To enable the feature, configure Google integration and make sure Gmail connector is selected in mail server settings:

Gmail connector

then you'll be able to select Gmail option when using "Add New Account" button on Email Accounts screen of your user account settings.

NB: by default, Gmail only allows IMAP/SMTP access if you authenticate via OAuth. To make username/password authentication work, you may need to allow less secure apps to access your account. Check debug logs or enable detailed error output to check if that's the issue you're facing. It might also be necessary to enable account access from every new IP address.

Note that, despite the name, allowing access for less secure apps doesn't actually reduce your account security. For example, if you access Gmail with Microsoft Outlook or Mozilla Thunderbird, Google treats that as insecure, just like any other kind of username/password authentication.