Skip to content

Mail Setup (Gmail OAuth / IMAP)

Bsynced CRM includes a built-in email inbox. You can connect any email account using either Gmail OAuth 2.0 (recommended for Google Workspace users) or IMAP / SMTP (for all other providers).

Integrations Settings

Option 1 — Gmail OAuth 2.0

Gmail OAuth is the simplest way to connect a Google account. It does not require your password and automatically stays in sync.

Setup Steps

  1. Go to Settings → Integrations → Gmail.
  2. Click Connect Google Account.
  3. A Google sign-in window opens. Sign in with the Gmail or Google Workspace account you want to connect.
  4. Grant the requested permissions (read and send email).
  5. You are redirected back to the CRM. The connection status shows Connected.

What Gets Synced

  • Inbox, Sent, and Bin (Trash) folders are synced.
  • New emails arriving in Gmail appear in the CRM Mail inbox within a few minutes.
  • Emails sent from the CRM appear in your Gmail Sent folder.

Google Workspace users

If you use Google Workspace (formerly G Suite) with a custom domain, the setup is identical. Use your @yourcompany.com address when signing in.

OAuth approval

If your Google Workspace admin has restricted third-party app access, ask them to allow Bsynced CRM in the Google Admin console under Security → API controls → App access control.

Option 2 — IMAP / SMTP

IMAP/SMTP works with any email provider: Microsoft Outlook, Office 365, Yahoo Mail, custom domain email, and more.

Setup Steps

  1. Go to Settings → Integrations → IMAP.
  2. Enter the following details:
FieldExample
Your nameJane Smith
Email addressjane@yourcompany.com
IMAP Hostimap.yourprovider.com
IMAP Port993 (SSL) or 143 (STARTTLS)
SMTP Hostsmtp.yourprovider.com
SMTP Port465 (SSL) or 587 (STARTTLS)
Usernamejane@yourcompany.com
PasswordYour email password or app password
  1. Click Test Connection. The CRM will verify that both IMAP (receive) and SMTP (send) can connect successfully.
  2. Click Save if the test passes.

App Passwords

Many providers require an app-specific password rather than your account password when two-factor authentication is enabled:

Common IMAP Settings

ProviderIMAP HostSMTP HostIMAP PortSMTP Port
Gmailimap.gmail.comsmtp.gmail.com993587
Outlook / Hotmailoutlook.office365.comsmtp.office365.com993587
Yahooimap.mail.yahoo.comsmtp.mail.yahoo.com993587

Per-User vs. Shared Mailbox

Each user connects their own email account under Settings → Integrations. This means emails sent by User A come from User A's address. If you want a shared mailbox (e.g. sales@company.com), connect that account to each user who should send from it.

WARNING

Per-workspace SMTP/IMAP credentials are stored securely and isolated between workspaces. One workspace cannot access another workspace's email settings.

Built with VitePress