CommSyncdocs
Open app
Channels

Gmail sign-in guide

What Sign in with Google needs from a Gmail or Google Workspace account, what a Workspace admin can allow, and what to do when Google blocks the sign-in.


Sign in with Google connects a Gmail or Google Workspace mailbox without an app password. You sign in on the page of Google, and CommSync never sees your password.

Sign in with Google comes to workspaces in stages. Until it reaches your workspace, the Gmail card connects with an app password. That path works as before. See Email accounts.

What CommSync asks Google for

Google shows one consent screen. CommSync asks for these scopes:

ScopeWhy CommSync needs it
https://mail.google.com/CommSync reads the mailbox over IMAP and sends your mail. Google offers no smaller scope for IMAP and SMTP.
openid, email, profileCommSync reads the address of the account that signed in.

Before Google shows its consent screen, CommSync shows one screen with two lists. The first list says what CommSync does with the mailbox:

  • It reads the mail and shows it in your inbox.
  • It sends the mail that you write.
  • It marks a message as answered when you reply to it.
  • It deletes mail when you delete it permanently in CommSync.
  • It copies your read, star, archive, spam, and trash actions to Gmail.
  • It runs the AI features that your workspace turns on.
  • It never uses your mail to train AI models.

The second list says who else can see the mail:

  • Teammates who have access to the line.
  • The people you share a conversation or a contact with.
  • The outbound webhooks that you register.
  • The AI apps that you connect over MCP.
  • The CommSync Agents that your workspace turns on.

The screen also shows the Limited Use statement of Google. Click I agree, continue to Google to accept it. CommSync records the version of the screen that you accepted, and the time, with the sign-in. The Privacy Policy has the full statement of how CommSync uses data from Google.

Google refuses a sign-in that runs inside the browser of another app. Open CommSync in Safari, Chrome, or another full browser, and try again.

The OAuth client ID of CommSync

A Google Workspace admin uses this ID to find CommSync in the Admin console and to trust it:

514620984222-jts3nhe3onhag7pqbienuhc4b3qeqgq8.apps.googleusercontent.com

This is the client ID of the production app of CommSync. The consent screen of Google shows its name, CommSync.

What Sign in with Google adds

A mailbox that you connect with Sign in with Google works like an app-password mailbox, plus three things:

  • New mail arrives in seconds. Gmail tells CommSync about each change, so CommSync does not wait for its next check.
  • Your mailbox and CommSync stay in step. Read, star, archive, move to spam, or delete a conversation in CommSync, and Gmail shows the change. Do these things in Gmail, and CommSync shows them too.
  • Mail goes out through Gmail. Each message appears in your Gmail Sent folder, in the conversation of the mail it answers.

The two-way sync is for the person who connected the mailbox. When a teammate reads or archives a conversation, only the CommSync view of that teammate changes.

A Gmail label changes the CommSync label with the same name. CommSync does not make a new label for a Gmail label.

Check that IMAP is on

CommSync syncs over IMAP.

  • A personal Gmail account has IMAP on. You do not need to change a setting.
  • A Google Workspace account uses the IMAP setting of its organization. A Workspace admin can turn IMAP off for everyone.

A Workspace admin checks the setting in the Google Admin console:

Open the Gmail settings

Sign in to admin.google.com. Open Apps → Google Workspace → Gmail → End User Access.

Check POP and IMAP access

Open POP and IMAP access. Make sure that Enable IMAP access for all users is on for the organizational unit of the user.

Check the mail client rule

If the setting limits IMAP to some mail clients, add the OAuth client ID of CommSync to the list.

Allow CommSync in Google Workspace

A Workspace admin can block third-party apps that ask for Gmail data. Google then refuses the sign-in with the error code admin_policy_enforced.

  • Google can show its own page first. The page says that your admin blocked the access, and it shows Error 400: admin_policy_enforced.
  • When Google sends you back, CommSync shows A sign-in policy of your organization blocks CommSync.

The error means that the Workspace admin has not allowed CommSync yet. Your account and your password are not the cause. Send this section to your admin. The admin can allow CommSync:

Open app access

In the Google Admin console, open Security → Access and data control → API controls. Click Manage Third-Party App Access.

Add CommSync

Click Configure new app. Search for the OAuth client ID of CommSync. Select CommSync.

Pick the scope of the rule

Pick the organizational units that can use CommSync.

Set the access

Set the access to Trusted. Save the rule.

The user then clicks Try again in CommSync.

Advanced Protection

The Google Advanced Protection Program limits which apps can read the mail of an enrolled account. Sign in with Google can fail for an Advanced Protection account. CommSync then shows the link Use an app password instead at once.

CommSync keeps you on Sign in with Google when it can work. It shows Use an app password instead below the sign-in button in these cases:

  • Two sign-ins with Google failed in the last 24 hours. A declined consent does not count.
  • Google blocked the sign-in by a policy of your organization, or because of Advanced Protection.
  • Google does not let your account sign in to CommSync yet.

The app-password path is the same form as before Sign in with Google. A Google Workspace admin can turn off app passwords too. Then only Sign in with Google can connect the mailbox.

Remove CommSync from your Google account

When you remove the mailbox in Settings → Email accounts, CommSync asks Google to revoke its access and deletes its tokens. CommSync does the same for each mailbox of a workspace that it deletes. These events delete a workspace:

  • The only owner leaves the workspace.
  • The owner deletes their account.
  • A trial workspace ends with no plan.

You can also remove CommSync yourself:

Open your Google account

Go to myaccount.google.com/permissions.

Remove CommSync

Select CommSync. Remove the access of CommSync.

After this, the mailbox shows Action required in CommSync. The conversations that CommSync already synced stay in your workspace. To ask CommSync to delete that mail, email support@commsync.ai.