To send or receive Gmail messages from CRM through mail servers, connect the account with an app password. This password is different from the one you use to sign in to Google: it is created so a service that supports SMTP/IMAP can access the mailbox.
Google recommends \u201CSign in with Google\u201D when an app offers that option. This guide covers the SMTP/IMAP app-password method used for this CRM configuration. See Google\u2019s official help about app passwords.
Before you start
- You must be able to sign in to the Gmail or Google Workspace account you want to connect.
- Turn on 2-Step Verification for that account. Google requires it to create an app password.
- For a Google Workspace account, the organization may manage or restrict this option. If it is missing, ask the administrator to check the security policies.
- Google revokes app passwords when you change the account\u2019s main password. You will then need to create a new app password and update CRM.
1. Create an app password in Google
- Open Google\u2019s App passwords page and sign in to the account you want to connect.
- If needed, first finish turning on 2-Step Verification.
- Enter a name that identifies the use, such as Upnify CRM, and select Create.
- Copy the password Google generates and keep it ready for the next step. Google shows the full code when it is created; do not share it or paste it into an email or comment.



2. Configure the account in CRM
- In CRM, open Personal settings > Email accounts and select New.
- Choose the account type you need: Outgoing to send; Incoming to receive; or Incoming/Outgoing for both.
- For the provider, select SMTP/IMAP. Enter the full Gmail or Google Workspace address and paste the app password you just created into the password field. Do not use your regular Google password.
- Enter the relevant server details from this table:
| Service | Server | Port | Security | Used for |
|---|---|---|---|---|
| IMAP | imap.gmail.com | 993 | SSL | Receive and sync email |
| SMTP | smtp.gmail.com | 587 | TLS | Send email |

- Save the settings. In the account list, check the status column and confirm that no incoming or outgoing error appears. If you configured both modes, check both.
Google publishes its Gmail IMAP settings and its guide to adding Gmail to another email client. For a work or school account, the Google Workspace administrator may control whether IMAP and app passwords are available.
If the connection does not work
- Google rejects the password: confirm that you entered the app password, not your regular Google password. If you changed the main account password after creating it, generate a new app password.
- You cannot find \u201CApp passwords\u201D: check that 2-Step Verification is on. The option may be unavailable if the account only uses security keys, has Advanced Protection, or belongs to an organization that restricts it.
- You are not receiving messages: check the IMAP server, port 993, and SSL. For Google Workspace, ask the administrator to confirm that IMAP is allowed for the account.
- You cannot send: check smtp.gmail.com, port 587, and TLS, along with the full email address used as the username.
