Upnify CRM
← Back to product

CRM · Communication

How to connect Gmail or Google Workspace with an app password

Set up Gmail in CRM using SMTP to send email and IMAP to receive it, with a Google app password.

How to connect Gmail or Google Workspace with an app password

Published on October 21, 2026

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.

What you will configure: SMTP to send email and IMAP to receive it. If you need only one of these functions, select only the corresponding mode in CRM.

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

  1. Open Google\u2019s App passwords page and sign in to the account you want to connect.
  2. If needed, first finish turning on 2-Step Verification.
  3. Enter a name that identifies the use, such as Upnify CRM, and select Create.
  4. 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.
App passwords option in Google Account security settings
In Google Account security, open App passwords.
Google form to name and create an app password for Upnify CRM
Use a name that helps you recognize which service the password is for.
Example of Google\u2019s screen after creating an app password, with the code hidden
Google displays the code when you create it. Copy it for CRM; the code in this image is hidden.

2. Configure the account in CRM

  1. In CRM, open Personal settings > Email accounts and select New.
  2. Choose the account type you need: Outgoing to send; Incoming to receive; or Incoming/Outgoing for both.
  3. 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.
  4. Enter the relevant server details from this table:
ServiceServerPortSecurityUsed for
IMAPimap.gmail.com993SSLReceive and sync email
SMTPsmtp.gmail.com587TLSSend email
CRM new account form with SMTP/IMAP selected and Gmail server settings entered
In CRM, select SMTP/IMAP and enter the server settings. Enter your app password before saving; this example account was not saved.
  1. 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.
Security: treat an app password as a credential. If you no longer need this connection, revoke it in your Google Account. If you create a new one, update the password saved in CRM.