Help Desk Software

Gmail POP3, IMAP, and SMTP settings

From version 3.4.0 Hesk supports OAuth authentication instead of a basic username/password one.

While Google still supports basic authentication with the help of App Passwords, you are encouraged to set up OAuth for Google mail instead if you are a Google Workspaces user.

Having problems getting Gmail to work with HESK? Try these settings.

» Email sending

To send emails using the Gmail server enter these details:

SMTP Host:
SMTP Port: 587
Encryption: TLS
SMTP Username: (your Gmail username)
SMTP Password: (you need to use a Google App Password, not your Gmail password!)

Also, make sure your "From email address" in HESK settings is set to your Gmail email address!

If you get an authentication error from Google, create & use Google App Passwords

Still no luck? Check with your host if they have port 587 blocked in your firewall.


» IMAP fetching

To fetch mail using IMAP from the Gmail server enter these details:

IMAP Host:
IMAP Port: 993
Encryption: SSL
IMAP Username: (your Gmail username)
IMAP Password: (a Google App Password)


» POP3 fetching

To fetch mail from the Gmail server using POP3 enter these details:

POP3 Host:
POP3 Port: 995
TLS Protocol: ON
POP3 Username: (your Gmail username)
POP3 Password: (a Google App Password)

Important: make 100% sure that "POP3 download" in your Gmail settings is set to "Enable POP for mail that arrives from now on". If not, Gmail will send all existing (even read) messages to HESK when it first connects.


» Error messages

Connection timed out

Required ports are probably blocked on your server's firewall. Ask your host to configure the firewall to allow TCP connections on ports 587, 995, and/or 993.

Some hosting companies will not do that due to their policies. In that case, you will need to, in order to integrate Gmail with HESK, find another host or try the HESK cloud.


Permission denied

You may need to use a Google App Password instead of your Google password.

Also, try logging in with your Google account here to unlock it for application access.

Click the "Continue" button to Allow access to your Google account.


Password error: [AUTH] Username and password not accepted.
Too many login failures

Your username and/or password are not correct, double-check them ad remember passwords are CaSe SeNSiTiVe!


Password error: [AUTH] Web login required
See this article


Error: 0 could not connect to the host ""

This could mean that:

  • required ports are blocked on your server's firewall. Ask your host to unblock TCP connections on ports 587, 995 and/or 993

- OR -

  • SSL certificate verification fails on your server. Try this:
  1. download this file
  2. save it somewhere to your server, for example to C:\wamp\ssl\cacert.pem
  3. open your php.ini file
  4. find line
    and change it to the location of the cacert.pem file while also removing the starting ;
  5. save and restart the server
  6. test again


Help Desk Software