Skip to main content

Connect an Existing Google/GSuite Account (App Password)

A manual connection method for users with specific security configurations or legacy Google accounts that do not support OAuth.

Updated over 2 months ago

What is an App Password?

An "App Password" is a 16-character passcode generated by Google that allows a non-browser app (like SendScale) to access your account. This method bypasses the standard 2-Factor Authentication (2FA) prompt, allowing our servers to log in via IMAP/SMTP protocols.

When to use this:

  • You are using a legacy (free) @gmail.com account for testing.

  • Your organization strictly prohibits OAuth connections but allows IMAP.

  • You are experiencing persistent OAuth token revocations.

Phase 1: Google Security Configuration

Before you open SendScale, you must configure your Google account.

  1. Log in to your Google Account and go to Manage your Google Account > Security.

  2. Enable 2-Step Verification: This must be turned ON. Google will not allow App Passwords without 2FA enabled.

  3. Generate Password:

    • Search for "App Passwords" in the search bar or find it under the 2-Step Verification section.

    • Select App: Choose "Mail".

    • Select Device: Choose "Other (Custom Name)" and name it "SendScale".

    • Click Generate.

  1. Copy the Code: Google will display a 16-character code in a yellow bar (e.g., wxyz abcd efgh ijkl). Copy this immediately. You cannot see it again once you close the window.

Phase 2: Connecting in SendScale

  1. Navigate to Accounts > Add New > Connect Your Existing Email.

  2. Instead of clicking the big Google button, look for the text link or option for "Any Provider / IMAP / SMTP" (or use the Google option and look for "Manual Setup" if available).

  3. Enter Credentials:

    • Email: Your full email address (e.g., [email protected]).

    • Password: Paste the 16-character App Password you generated in Phase 1. Do not use your regular login password.

  1. IMAP/SMTP Settings (If prompted):

  • IMAP Host: imap.gmail.com | Port: 993 | SSL: Yes

  • SMTP Host: smtp.gmail.com | Port: 587 (TLS) or 465 (SSL)

  1. Click Connect.

Verification

SendScale will attempt to send a "Test Email" to itself to verify the SMTP channel is open. If successful, the account will appear in your dashboard.

Pro Tip: If the connection fails immediately, check your Google "Forwarding and POP/IMAP" settings in Gmail to ensure "Enable IMAP" is toggled ON.

Did this answer your question?